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Preface 



This manual presents reference information about using NCBridge on network 
computers. This manual is written for system administrators and network 
administrators responsible for installing and administering one or more network 
computers in a distributed-computing environment. 



Assumptions 



The procedures in this manual assume: 

• You understand your operating system and are familiar with the 
administration of the intended host computer. 

• You are familiar with network protocols and understand the concepts related 
to local-area networks (LAN). 

• You are familiar with the X environment, including window managers and 
display managers. 



Manual Organization 



This manual contains the following chapters and appendices: 

Preface - explains the terminology and typographical conventions used in 
this manual. It also contains a list of related documents. 

Chapter 1, Introduction - gives an overview of network computers, including 
a features description, and strategies for installing and booting network 
computers. 

Chapter 2, Remote Configuration - gives information about each of the 
remote configuration commands, including parameters and examples. 

Chapter 3, Setup - describes the Setup local client. Setup provides an 
easy-to-use interface for configuring and customizing the network computer. 

Chapter 4, Boot Monitor - describes how to use the boot monitor. It includes 
an explanation for each of the boot monitor commands. 

Chapter 5, Diagnostics - describes the two self-test diagnostic programs: 
Kernel Self-Test and Extended Self-Test. 

Chapter 6, Setting Up SNMP - describes the contents of the mib.txt file. 



NCBridge Reference Manual 



XVII 



Preface 



Chapter 7, Tek220 and Tek340 Emulators - provides information about using 
and configuring the Tek220 and Tek340 emulators. 

Appendix A, Printing - describes printing capabilities and hardcopy utilities. 

Appendix B, Keyboards - describes the optional keyboards, the key codes, 
and the default keysym-to-key-code mappings used by the keyboards. This 
appendix also includes information about remapping key codes and setting 
keyboard configuration. 

Appendix C, CSLIP - contains information about using CSLIP to connect a 
network computer to a remote IP network. This also provides information 
about printing over a serial line via a CSLIP connection. 

Appendix D, Scripting Language - describes the scripting language that can 
be used to automate network computer functions. 
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Conventions 

Figure 1 illustrates the typographical conventions used in this manual. 

The following terminology is used to describe mouse operations. 

Pointing: Using the mouse to position the pointer on an object on the 
display. 

Moving: Using the mouse to change the location of the pointer on the 
display. 

Clicking: Pressing and releasing a mouse button without moving the 
pointer. 

Dragging: Pressing and holding down a mouse button while moving the 
pointer. 

Releasing: Releasing the mouse button to complete a dragging action. 
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Definition or file name - 



Enabling BOOTP 




Command (type as Is) 

Prompt (do not type) . 

Variable (substitute 
the correct value) 

Path 



Response on screen 
or lines in a file 



Bootstrap protocol, booip'i is the recommended way to establish < 
to the Netstation in an internet protocol environment, ibootp ohta 



1 . Vchify that the bootpd and boolptab files arc in the /etc dircctc] 
— • #[ [is tetc/bootp* : 

2. If they are not there: 



^ 



# cp /tekxp/bin/<ft(«J>/bootp<l /etc 



"S. Edit the /etc/hosts\ file to add the Netstation internet addrcssc 

— ll2B.07.60.30 Portland 



Program name 
Menu or key name - 

Menu button name 

Required variable - 

Required switch - 
(choose one) 

Optional variable 



Entering Serial Parameters with Set} 

The parameters on the host computer must match the paramq 
in order for serial communications to work. Your system adn 
in the remote configuration file, or tell you what parameters A 
them \n\Setup. 



To verify or change your serial parameters: 



/ 1. Press jSeiu pi 

2. Select Setup>\^ 

3. Drag on the Configuration Summaries menu and release on 5 

4. Determine if your cahle is connected to Serial Port or 1 , 



5. Select die Return to Main Menu: button. 
Table 1. Boot Monitor Commands 



-fcteeJhis Command: 



Authori ze \au thoriztition-key\ 



BMethodlittW or MOP or TFTP or NFS', [Read size} 



To: 



Enable otf 



Specify 



Figure 1 Typographical Conventions 
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Map to the NCBridge Documentation 

Table 1 presents the contents of the manuals in the NCBridge documentation 
set. These manuals are included on the Documentation CD-ROM. 

Table 1 Available NCBridge Documentation 



Manual Title 


Contents 


NCBridge User Manual 


This manual provides information on using the network 
computer with NCBridge software. 


NCBridge Reference Manual 


(This manual.) Provides explanation of all NCBridge, 
Setup Main Menu, and Boot Monitor commands; plus 
Diagnostics, SNMP, Tek220 and Tek340 Emulator, 
Printing, Keyboard, CSLIP, and Scripting Language 
setup. 


3270 User Manual 


Provides information on using the OpenConnect 3270 
emulator. 


3270E/5250 User Manual 


Provides information on using the TEEMX 3270E/5250 
emulators. 


NCBridge for UNIX Installation 
and Configuration Manual 


Provides information for installing NCBridge on a UNIX 
server and explains how to configure the network 
computer to download and execute the NCBridge 
software. 


NCBridge for VMS Installation 
and Configuration Manual 


Provides information for installing NCBridge on a VAX 
VMS server and explains how to configure the network 
computer to download and execute the NCBridge 
software. 


NCBridge for Windows NT 
Installation and Configuration 
Manual 


Provides information for installing NCBridge on a 
Microsoft Windows NT server and explains how to 
configure the network computer to download and execute 
the NCBridge software. 



This book, available in local bookstores, presents window system concepts and 
includes tutorials for many client programs: 

• X Window System User's Guide — O'Reilly & Associates, Inc. 
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Preface 



The following documentation from your computer manufacturer would be 
helpful to look up additional options, subnet masking, and broadcast addresses: 

• System Administrator's Manual 

• Network Administrator' s Manual 



Discontinued Software Features 

As NCD continues to add new features to make your NC hardware more 
valuable, we are forced to discontinue support for some of the older software 
features. The following is a list of features that were supported in NCBridge 3.2 
and earlier software releases, but are not supported in NCBridge 4.0. 

Serial Xpress 

Local OpenLook Window Manager 

X Blink Extension 

Local 3179G Terminal Emulator 

Sun Audio Intercept Driver for Sun OS Environments 

XIE 

SIE 

Display PostScript and Acrobat Reader 

Flash Control Console Client 

Support for XP10 X terminals 

Serial Xpress 

Serial Xpress enabled a NC or X terminal to connect to a remote host and 
transmit X Windows data over an RS-232 cable, or indirectly over a phone line 
using modems. The NC can now be connected using PPP over an RS-232 
connection, or connected to a DSL or ISDN connection using the standard 
network port to provide remote access to a host replacing the need for Serial 
Xpress. 
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Local OpenLook Window Manager 

The local OpenLook window manager (OLWM) is a window manager for the 
X Window System that implements parts of the OPEN LOOK graphical user 
interface, original developed by Sun Microsystems, Inc. This feature was 
previously provided to allow the OLWM program to run as a local client on the 
Network Computer (NC) to help off load server resources. The OLWM window 
manager is still supported on the NCs under X Windows by simply running 
OLWM directly from a Sun host. OLWM is one of the standard window 
managers on Sun's Workstation products running Solaris. NCs still offer Local 
Motif (MWM) or (XPWM) window managers to use in place of OLWM where 
a local window manager is necessary. 

Local 3179G Terminal Emulator 

The local 3179G Terminal Emulation is no longer included. The local IBM 
3 179G Terminal Emulation included IBM3720 support along with special IBM 
Graphics functions (GDDM), including support for older IBM host graphics 
applications. The NC still offers support for IBM3270 Emulation. 
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Chapter 

Introduction 
Overview 



NCD Network Computers (NC) support the X Window system, ICA protocol 
for PC application access, local terminal emulators, and a local Netscape NC 
Navigator browser. The X Window System provides a way to view several 
textual or graphical applications on a single display. X windows are an industry 
standard that has been ported to many platforms. Applications that run on X 
windows are insulated from differences in the underlying operating system; 
they behave exactly the same on any X-supported platform. 

The Netscape NC Navigator browser is a direct port of the Netscape Navigator 
browser that runs on a Sun Solaris operating system. The Navigator browser 
allows users to access Web pages and to download Java applets for local execution. 



Network Computer Environment 



NCD Network Computers support a distributed computing environment, where 
processing can be shared by one or more of host computers rather than by one 
centralized computer. This allows applications competing for resources at any 
given time to be parceled out across the network, so they have minimum impact 
on each other. The hosts are connected by a network, which allows files to be 
transferred among computers and also allows processes on different computers 
to communicate with each other. 

Several NCs can also be linked to each of the host computers over the network. 
Because the connections are not hardwired, a network computer can easily 
communicate with any host on the network. As in the host-to-host case, the 
network computer-to-host link allows the network computer to send and receive 
files over the network and to establish communication between processes running 
on the network computer and on the host. 
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X System Model for the NC 



In X terminology, an application process is called a client and the process that 
controls the display is called a server. Figure 1-1 shows the X Window System 
client-server model, often referred to as core X. The client communicates with 
the server via a byte stream, sending X requests and receiving X events from 
the server. 

The client and server do not necessarily run on the same host. They often 
communicate over a network, as shown in Figure 1 - 1 . An X server can listen to 
several clients at once, providing input and displaying output for each in a 
separate window. A collection of simultaneously executing X clients is called 
a session. If necessary, each client can run on a different host, spreading the 
load across the system for the most efficient use of available resources. 
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Figure 1-1 X System Model for the NC 
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Network Computer Software 



Once the system has been set up, the network is totally transparent. The X 
software cannot tell the difference between local clients, that is, applications 
running on the same host as the server, and remote clients running on other 
hosts. When the proper defaults are in place, users cannot tell the difference, 
either. 



Network Computer Software 



This section provides an overview of the NCBridge software used for booting 
and running XP and NC series network computers. The software comes on 
CD-ROM discs (also on magnetic tape for VMS only). The media contain boot 
files (the X server image), configuration files, fonts, and font tools to support 
network computers. Files with .900 extensions (*.900) support NC900 series 
network computers and so on, as shown in Table 1-1. 

Table 1-1 File Extensions for Supported Models 



Binary File Extensions 


Models These Files Support 


*.900 


NC900 Series 


*.500 


NC200/NC400 Series 


*.350 


XP Series except XP330 


*.330 


XP330 Series 


*.300 


XP/NC200/NC400/NC900 Series 



X Server 



The software environment is the X Window System, Version 1 1 , Release 6. The 
X server monitors input from the keyboard and mouse, and sends output to the 
display. The server software is available in two options: 

• RAM-based — The server is supplied on CD-ROM discs (and magnetic tape 
for VMS), loaded onto a host, and downloaded from the host to the network 
computer RAM using nfs, tftp or MOP. 

• Flash Memory — The server is resident in flash memory on a network 
computer. 
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Local Clients 



Most X applications (clients) run on a host computer, but some local clients can 
run on an NCD network computer. Depending on the type of network 
computer, the following local clients are available: 

Setup provides a user interface for setting up and viewing network computer 
configuration parameters and running utilities such as ping. 

Motif Window Manager provides a local window manager. 

XP Window Manager provides a local window manager. 

HostMenu provides a list of available login hosts. 

Low Memory Indicator displays an alert if available memory falls below a 
specified limit. 

Xlock provides a way to lock a network computer's keyboard only, or the 
keyboard and display. 

Input Configuration Manager configures a variety of input devices, such as 
lightpens and tablets. 

Navio, Netscape, Netscape_Lite clients are web browser clients. 
Netscape_Lite is the same as Netscape minus email and news functions. 

TeemX clients for IBM 3270E and 5250 Emulators (latest emulators). 

3270 Emulator and 3278 Emulator printer emulator client (older emulators). 

Session Clients support these sessions: 

Telnet VT220 or VT340, LAT VT220 or VT340, CTERM VT220 or VT340, 

Serial (TIP) VT220 or VT340, and CSLIP. 

Client Launcher provides a way to start local clients by selecting clients from 
a menu. 

Analog Video Player displays analog video sources on a network computer. 

Digital Video Player displays digital video files on a network computer. 
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Audio Player provides a way to record and play audio files on a network 
computer. 

Audio Mixer provides a way to record and play several audio sources. 

Authorization Key Manager provides a way to update the authorization keys 
of several network computers at once. 

Touchscreen Calibration client provides a graphical interface for calibrating 
the Trident Touchscreen. 

XClock client for displaying current time from time-server host. 

WinDD client that allows you to access Windows applications from 
Windows NT hosts. 

Llogin client provides LAT login sessions. 

Lfm client allows saving files from a host to an optional local floppy drive. 
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Chapter £ 

Remote Configuration 
Overview 

The remote configuration file (xp.cnf) is used to specify the configuration 
information for all network computers (NCs) that boot from a specific host. This 
facility aids the system administrator in efficiently setting up and maintaining 
NCs. All NCs can be controlled from a central location, eliminating the need to 
individually set up each one. 

Also included is a master copy of the remote configuration file called xp_cnf.txt. 
This file is provided as a backup copy to be used in case your xp.cnf file is 
corrupted or in some other way becomes unusable. 

Note: If you previously had an xp330.cnffile, rename it to something 
else or remove it. The network computer no longer reads it. 

To use a single remote configuration file to configure different network 
computer models, use the remote configuration file (xp.cnf) provided in 
. . . /tekxp/boot/conf ig/ on UNIX systems. For Windows NT and 
Windows 2000 hosts, this file is located in . . . \tekxp\boot\conf ig\. For 
VMS hosts, xp.cnf is located in the tek$xp_CONFIG : . directory. This file is 
read by all NCD NCBridge network computers. 

To use separate remote configuration files to configure different network 
computers, create the remote configuration files and give them unique names. 
Then use the select command to specify which remote configuration file a 
network computer is to use. The select command is discussed in the 
Restricting Configuration Parameters section in this chapter. 

Note: If you had a previous installation, your configuration files were 
preserved, and the new configuration files renamed with a .tmpl 
suffix. Ifxp.tmpl exists, compare it to your existing xp.cnf file to 
see if features have been added, or if the syntax has changed. 
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VMS Logicals 



For VMS hosts, the logicals listed in the table below point to model-specific 
remote configuration files. By default, these logicals all point to the same 
directory. You can display all VMS logicals by issuing a show log command 
in VMS. To view only the NCBridge logicals on the VMS system, use the show 
log TEK* command. Table 2-1 shows all the NCBridge logicals. 

Table 2-1 VMS Logicals 



For NC900 Series 


TEK$N916_CONFIG: 


TEK$N9 1 6PL_CONFIG: 


TEK$N932_CONFIG: 


TEK$N916B2_CONFIG: 


TEK$N948_CONFIG: 


TEK$N916B2PL_CONFIG: 


TEK$N980_CONFIG: 




For NC400 Series 


TEK$NC400_CONFIG: 


TEK$N400X2_CONFIG: 


TEK$NC417_CONFIG: 


TEK$N400XPC_CONFIG: 


TEK$NC421_CONFIG: 


TEK$N400WEB_CONFIG: 




TEK$N400DM_CONFIG: 


For NC200 Series 


TEK$NC200E_CONFIG: 


TEK$N200X_CONFIG: 


TEK$NC200H_CONFIG: 


TEK$N200XPC_CONFIG: 


TEK$NC215_C0NFIG: 


TEK$N200XPC2_CONFIG: 


TEK$NC217_CONFIG: 


TEK$N200XPL_CONFIG: 


TEK$NC217H_CONFIG: 


TEK$N200WEB_CONFIG: 


TEK$NC220S_CONFIG: 


TEK$N200FAST_CONFIG: 


TEK$NC22 1 H_CONFIG: 




For XP400 Series 


TEK$XP400_CONFIG: 


TEK$XP417C_C0NFIG: 


TEK$XP400D_CONFIG: 


TEK$XP419C_CONFIG: 




TEK$XP419G_CONFIG: 


For XP350 Series 


TEK$XP350_CONFIG: 


TEK$XP356_CONFIG: 


TEK$XP354_CONFIG: 


TEK$XP358_CONFIG: 
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Table 2-1 VMS Logicals (continue 


d) 


For XP330 Series 


TEK$XP330_CONFIG: 


TEK$XP337_CONFIG: 


TEK$XP334_CONFIG: 


TEK$XP338_CONFIG: 


For XP200 Series 


TEK$XP200_CONFIG: 


TEK$XP217C_CONFIG: 


TEK$XP200CH_CONFIG: 


TEK$XP217CH_CONFIG: 


TEK$XP214C_CONFIG: 


TEK$XP2 1 9CH_CONFIG : 


TEK$XP214M_CONFIG: 


TEK$XP2 1 9MH_CONFIG: 


For XP1 00 Series 


TEK$XP100_CONFIG: 


TEK$XP 1 1 7C_CONFIG: 


TEK$XP1 14C_CONFIG: 


TEK$XP 1 1 9C_CONFIG: 


TEK$XP 1 1 5M_CONFIG: 


TEK$XP 1 1 9M_CONFIG: 
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Command Syntax 

The remote configuration file uses the following command syntax: 

• A command-line consists of a single command keyword followed by one or 
more parameters. White space, which is any combination of spaces or tabs, 
separates the command and its parameters. White space can also precede the 
command to improve readability. A command-line is terminated by either a 
newline character or a #, which introduces a comment. 

• A comment begins with #. Comments and blank lines are ignored. Comments 
can appear on the same line as a command; once # is encountered, all 
subsequent text is ignored until after the next newline. 

• A parameter is either a keyword or a string. A parameter begins with any 
character that is not white space, #, or a newline, and is terminated by the 
next character that is white space, #, or a newline. A parameter can be 
enclosed in double quotation marks. These quotation marks are removed 
from the ends of the parameter before the parameter is used. A pair of double 
quotation marks with nothing between ("") signifies a null string. If double 
quotation marks appear at one end of a parameter but not at the other, the 
character is removed, a warning message is printed in the Console, and the 
remaining string is used as the parameter. 

Note: Some commands take multiple required and/or optional 

parameters. You must provide all required parameters for a 
command. The order of the commands in the following 
sections follows the recommended order for commands 
within the remote configuration file. You need not enter a 
command unless you want to set the characteristic to 
something other than the default. Note that not all commands 
have default settings. If a command fails, the parameter is left 
unchanged. 
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Editing the Remote Configuration File 

To begin, login as root for UNIX hosts, system for VMS hosts, or administrator 
for Windows NT hosts. Change the file permissions of the remote configuration 
file before you start, making it readable by all, and writable by owner. 

All the lines in the file are commented out, with their default values shown. The 
recommended strategy is to edit the file to enable only the specific commands 
you need to set up your site. User preference entries, such as screen_saver, or 
entries where values may vary, such as default _visual, should be left alone. 

The order in which commands appear in the remote configuration file is 
significant because some commands depend on the prior execution of another 
command. For example, xdmcp_server can take either a host name or an IP 
address as its parameter. If you use a host name, the name must be in the host 
table when the xdmcp_server command executes. Thus all host_table 
commands should precede any xdmcp_host commands in the configuration 
file. Another example is if you are using an NFS server. In this case, you would 
have to define the host name and address in the nfs_table entry before you could 
assign it as an NFS server. 

If an error is found, an error message with the line number where the error 
occurred appears on the system Console window, and command processing 
continues. In general, if a command appears more than once, the last setting 
read is the one used. For commands that allow multiple settings, such as the 
commands that fill tables, each command encountered adds another entry in the 
table. 

Notes: Settings for TDEnet (an implementation of the DECnet 

protocol), MOP, DAP, Cterm, and VMS autologin only apply to 
environments with DECnet running on one or more hosts. 
DECnet does not support Domain Name Service (DNS). You 
must have the DECnet node number defined. 

Internet protocol (IP) names, addresses, gateways, tftp, NFS, 
Domain Name Service (DNS) and Telnet only apply to 
environments using TCP/IP network protocol. You must have 
the IP parameters set (see the section, TCP/IP Configuration on 
page 2-51 for more information). 
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The xp_cnf.txt File 

The xp_cnf.txt file is complete with liberal comments and all the settings. This 
file should be read carefully and used as a guide in selecting the command-lines 
for your xp.cn/file. 

Note: Do NOT modify or delete the xp_cnf.txt file. Instead make a copy 
for your changes or use the xp.cnffile. 

Both xp_cnf.txt and xp.cnf files are located in . . . /tekxp/boot/conf ig/ on 
a UNIX system. For Windows NT and Windows 2000 hosts, these files are 
located in . . . \tekxp\boot\conf ig\. On VMS hosts, xp.cnf is located in 
tek$xp_config : . Please refer to the xp_cnf.txt file for detailed information 
about xp. cnf commands. 

Example Configuration Files 

Examples 2-1 and 2-2 show sample remote configuration files for UNIX, 
Windows NT, and VMS hosts. 
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Example 2-1 Sample UNIX or Windows NT Remote Configuration File 

##***** Network Tables ***** 

# 

ip_host_table "128.07.60.01" "Oregon" 

gateway_table "0.0.0.0" "128.07.60.100" 

gateway_table "128.07.70.00" "128.07.60.110" 

nfs_table "Oregon : /tekxp" "/tekxp" "8192" 

# 

Note: The aforementioned nfsjable example only works on 
Windows NT if NFS is installed on the NT server. 

##***** X Environment Configuration ***** 

# 

backing_store ENABLED 

host_connect_method WINDD 

default_host_list WINDD 

# 

##***** TCP/IP Configuration ***** 

# 

subnet_mask 255.255.255.0 

broadcast_address 128.07.60.255 

name_server_l 128.07.60.01 

Example 2-2 Sample VMS Remote Configuration File 

## $Header: xp . cnf 

# 

##***** Network Tables ***** 

# 

tde_host_table "11.20::" "idaho::" 

# 

# 

##***** X Environment Configuration ***** 

# 

backing_store ENABLED 

host_connect_method VMS 

vms_autologin_transport TDENET 

vms_autologin_tdenet_host "idaho: : " 

# 
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The sections in this chapter follow the order of the remote configuration file on 
the media and are named after the features. The features that apply to each 
platform (that each platform supports) are indicated by a check mark ( ♦ ), as 
shown in Table 2-2. 



Table 2-2 Features by Platform Chart 



I 



Feature 


XP 


NC200 and 
NC400 


NC900 


Network Tables 




♦ 




File Host Configuration 




♦ 




X Environment Configuration* 




♦ 




Boot Configuration 




♦ 




TCP/IP Configuration 




♦ 




TDEnet Configuration Parameters 




♦ 




Serial Port Configuration Parameters 




♦ 




Net to Port Configuration 




♦ 




Keyboard Configuration Parameters 




♦ 




Input Extensions Configuration Parameters 




♦ 




SNMP Configuration 




♦ 




Token-Ring Interface 




NC200 only 




Local Clients 




♦ 




LAT Configuration 




♦ 




Miscellaneous Functions 




♦ 




Including Other Configuration Files 




♦ 





*One of the commands covered in the X Environment section is 
which is only available on the XP100D, XP400D, and NC400 



the dual_display_configuration, 
with dual monitor cards. 
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Table 2-2 Features by Platform Chart (continued) 



Feature 


XP 


NC200 and 
NC400 


NC900 


Restricting Configuration Parameters 


♦ 






Tek220 and Tek340 Configuration 


♦ 






Black and White Pixel Compatibility 


♦ 






Flash Memory Configuration 


♦ 






HostMenu Configuration 


♦ 






Local Print Spooler/Printing 


♦ 






DEC Session Manager Configuration 


♦ 






TFTP Daemon 


♦ 






Exiting Telnet 


♦ 






Analog Video Configuration 


XP300V and 
X317CVJ 






Console Configuration 


♦ 






WinDD Configuration 


♦ 






RSHD Configuration 


♦ 






HW MPEG Player Configuration 


XP400 






CSLIP Settings 


♦ 






Script Variables 


♦ 
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Configuring the Host 

This section describes the remote configuration commands for the host 
configuration. Here is a list of these commands and their locations: 

Command Page 

clear_table 2-12 

ip_host_table 2-12 

tde_host_table 2-13 

gateway_table 2-13 

nfs_table 2-15 

ip_host_entry 2-16 

tde_host_entry 2-16 

gateway_entry 2-17 

nfs_entry 2-17 

enable_tdenet 2-18 

enable_lat 2-18 

lat_service_entries 2-19 

lat_services_table 2-19 

show_lat_services 2-20 

file_access_l 2-21 

file_host_name_l 2-22 

file_path_l 2-23 

file_access_2 2-23 

file_host_name_2 2-23 

file_path_2 2-23 
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Network Tables 



The network tables contain entries that are loaded into the network computer 
during the boot process. Typically, this is frequently accessed network 
information you always want stored in the network computer's NVRAM, such 
as the boot host, login host or font host. 

Another typical use for the network table entries in the remote configuration file 
is to define host names and addresses for use with other remote configuration 
commands. For example, there must be an ip_host_table command with the 
appropriate information in order to use an nf s_table command. 

When the remote configuration entries are read, existing values in the network 
computer's NVRAM are temporarily overridden. These temporary NVRAM 
settings can be saved with the save_current_settings command in the 
remote configuration file or with the Save Settings to File option in Setup. 

Entries encountered in the remote configuration file are added to the NVRAM 
table, overlaying any existing entries, until it is full. Subsequent entries in the 
remote configuration file are ignored. Use the RAM table commands 

fip_host_entry , tde_host_entry , gateway_entry , and 

nf s_entry) or the optional configuration files hosts.tbl and nodes.tbl to 

maintain a complete list of host names and addresses. 

There are four network tables whose entries are stored in the NC's NVRAM. 
Each table can have up to four entries. These are the tables: 

• ip_host_table is used in environments supporting TCP/IP addressing. 

• tde_host_table is used in environments supporting a DECnet protocol. 

• gateway _table is used to specify router information in TCP/IP environments. 

• nfs_table is used to specify NFS mounts for file and font transfer in 
TCP/IP environments. 

Also, the following table is stored in RAM: 

• lat_services_table is used in environments supporting the LAT protocol. 

Note: Additional entries (such as multiple IP host, the host, gateway, 
and nfs entries — not tables) are stored in RAM, not NVRAM. 
Multiple entries are allowed. 
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clear_table 

clear_table IP_HOST or TDE_HOST or GATEWAY or NFS or 
DISPLAY_ACCESS 

Deletes the entries from the specified NVRAM table. 

Parameters 

IP_HOST deletes the entries in the IP host table. 

TDE_HOST deletes the entries in the TDE host table. 

GATEWAY deletes the entries in the Gateway table. 

NFS deletes the entries in the NFS table. 

DISPLAY_ACCESS deletes the entries in the Display Access table. 

In this example, IP host table and NFS table entries are deleted from NVRAM: 

clear_table ip_host 
clear_table nfs 

ip_host_table 

ip_host_table ip_address hostname 

Specifies Internet host-table entries by Internet Protocol address and host name. 
The first four entries of this table can be stored in NVRAM using the Setup Menu 
or by using the save_current_settings command in the xp.cnf file. 
Additional table entries or entries made with the ip_hos t_entry command are 
stored in RAM. Host resolution can also be accomplished with Domain Name 
Service (DNS) providing a DNS host is available. DNS simplifies host 
configuration maintenance. 

Parameters 

ip_address specifies the IP address, which must be in dotted-decimal format. 
hostname specifies the name of the host. 

In this example, the host Oregon has IP address 128.07.60.01: 

ip_host_table "128.07.60.01" "Oregon" 

Note: Four internet hosts may be specified. For additional hosts, use the 

ip host entry command or the optional hosts.tbl file described in 
Chapter 4 of the NCBridge Installation and Configuration manual for 
your operating system. 



2-1 2 NCBridge Reference Manual 



tde host table 



tde_host_table 

tde_host_table TDEnet_address node_name 

The network computer uses these entries to map TDEnet addresses and names. 
The first four entries of this table can be stored in NVRAM using the Setup Menu 
or by using the save_current_settings command in the xp.cnf file. 
Additional table entries or entries made with the tde_host_entry command are 
stored in RAM. 

Parameters 

TDEnet _addr ess specifies the TDEnet address. 

node_name specifies the name of the host. 

In this example, the TDEnet host table contains an entry for the host idaho at 
TDEnet address 11.20: 

tde_host_table "11.20" "idaho" 

Note: Four TDEnet nodes may be specified. For additional nodes, use 
the tde_host_ en try command or the optional nodes.tbl file 
described in Chapter 4 of NCBridge Installation and 
Configuration manual for your operating system. 

gateway table 

gateway _table ip_net_address ip_gateway_address 

The network computer uses this command to specify a gateway-table entry by 
network and IP address. Gateway entries correlate the address of a remote network 
that the NC needs to access with the address of the gateway host. The first four 
entries of this table can be stored in NVRAM using the Setup Menu or the 
save_current_settings command in the xp.cnf file. Additional table 
entries or entries made with the gateway_entry command are stored in RAM. 

Parameters 

ip_net_address specifies the table entry for the network gateway. 

ip_gateway_address specifies the IP address for the network gateway. The 
addresses must be in decimal-dot format. 

In this first example, network 9 is accessed through IP address 128.07.60.100: 

gateway_table "9.0.0.0" "128.07.60.100" 
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In this second example, all networks not explicitly specified — as in the previous 
example — are accessed through IP address 128.07.60.100: 

gateway_table "0.0.0.0" "128.07.60.100" 

Note: Four gateways may be specified. For additional gateways, use 
the gateway en try command or the optional gateway. tbl file 
described in Chapter 4 of the NCD NCBridge Installation and 
Configuration manual for your operating system. 

Using the Route Manager 

The route manager enables a site to take advantage of multiple routers: if a 
router fails for longer than the TCP connection timeout, the route manager 
routes traffic to other routers to minimize the lost connections. Route manager 
balances the network load among the remaining routers until the down router 
comes back on line. The route manager continues to check the status of the 
down router, and waits until it is up and back at normal capacity before 
rerouting any connections back. The route manager is transparent to the user. 

The route manager is started with the xp . cnf start command: 
start ROUTE_MGR 

The route manager uses routers specified with the gateway_table and 
gateway_entry remote configuration commands, the gateway.tbl file, the 
bootptab file (if the terminal is configured to use bootp protocol), or the 
Gateway screen of the Network Tables and Utilities menu in Setup. If different 
default gateways are specified in any of these locations, then the bootrom uses 
the first specification and the os uses the last. Both routers need to be up in order 
for the network computer to boot. 
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nfs_table 

nfs_table file _system_name local_directory transfer _size 

The network computer uses these table entries to map remote file systems to 
local mount points. You can specify a transfer read size for each mount point. 
NFS directories are frequently used to access additional fonts. The directories 
must be exported on the host to be accessible to the network computer. To 
access files or fonts through NFS, either file_access_l or file_access_2 must be 
set to NFS. Additional table entries or entries made with the nf s_entry 
command are stored in RAM. 

Notes: Before NFS directories can be specified, the remote host must 
either be specified by the ip_host_ tabl e command, stored 
in NVRAM, or domain name service must be enabled. NFS 
must also be running on your host with the directories 
exported. Check the NCD NCBridge Installation and 
Configuration manual for NFS setup information or consult 
the vendor documentation for your host computer. 

The first four NFS table entries can be stored in NVRAM via 
the Setup Menu or by using the savecurrentsettings 
command in the xp.cnffile. Additional table entries are stored 
in RAM. You can also store table entries in RAM using the 
nfs_ en try command. 

Parameters 

file _sy 'stem _name specifies the remote host path. 

local_directory specifies the local path. 

transfer _size specifies the block size for NFS transfers (128 to 8192). 

In this example, /ul/tekxp is the path defined for the exported NFS directory 
from host Oregon: 

nfs_table "Oregon : /ul/tekxp" "/tekxp" "8192" 

The following examples illustrate setting the transfer block size from oregon at 
8192 bytes and the transfer block size from arizona at 1024 bytes. 

nfs_table "oregon : /tekxp" "/tekxp" "8192" 
nfs_table "arizona : /vol" "/volp" "1024" 
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ip_host_entry 

ip_host_entry ip_address hostname 

Specifies Internet Protocol host addresses and names and stores them in RAM, 
not NVRAM. Multiple entries may be listed in the xp.cnf file. 

Parameters 

ip_address specifies the IP address in decimal-dot format. 

hostname specifies the name of the host. 

The following example shows an entry for a host called "Vancouver": 

ip_host_entry "128 .07.60.01" "Vancouver" 

tde_host_entry 

tde_host_entry TDEnet_address node_name 

Specifies TDEnet addresses and host names and stores them in RAM, not 
NVRAM. Multiple entries may be listed in the xp.cnf file. 

Parameters 

TDEnet_address specifies the TDEnet address. 

node_name specifies the name of the host. 

The following example shows an entry for a host called "Washington" (note the 
double colon syntax): 

ip_host_entry "11.20: :" "Washington" 
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gateway_entry 

gateway _entry ip_net_address ip_gateway_address 

This command maps network addresses to gateway routers and stores them in 
RAM, not NVRAM. Multiple entries may be listed in the xp.cn/file. Refer to 
Using the Route Manager on page 2-14 for information on multiple routers. 

Parameters 

ip_net_address specifies the table entry for the network gateway. 

ip_gateway_address specifies the gateway IP address in decimal-dot format 

In the following examples, the first example shows a typical gateway 
configuration. The second example shows a default gateway for networks with 
a single node going to the outside world. 

gateway_entry "128 . 07 . 70 . 00" "128 .07.60. 110" 

gateway_entry " . . . " "12 8 . 7 . 6 . 1" 

nfs_entry 

nfs_entry file _system_name local_directory transfer _size 

Maps NFS mount points to local directory structures and stores them in RAM, 
not NVRAM. Multiple entries may be listed in the xp. cnf file. You can specify 
a transfer read size for each mount point. 

Parameters 

file _sy stem _name specifies the remote host path. 
local_directory specifies the local path. 

transfer _size specifies the block size for NFS transfers (128 to 8192). 
The following example shows a typical nfs entry: 

nf s_entry "Oregon: /tekxp" "/tekxp" "8192" 
nf s_entry "arizona: /vol" "volp" "1024" 
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enable tdenet 

enable_tdenet YES or NO 

Specifies whether TDEnet is started via the remote configuration file. TDEnet 
must be authorized for the network computer, and then enabled. For 
information about authorizing a feature, refer to the Authorize command in 
Chapter 4, Boot Monitor. 

Parameters 

YES specifies that TDEnet is enabled. This is the default if the TDEnet 

address is entered and the option is authorized on the network 
computer. 

NO specifies the TDEnet is not enabled. This is the default if no 

TDEnet address is entered. 

In this example, TDEnet is enabled: 

enable_tdenet YES 

enable lat 

enablejat YES or NO 

Specifies whether LAT is started via the remote configuration file. 

Parameters 

YES specifies that LAT is enabled. This is the default if authorized on 

the network computer. 

NO specifies that LAT is not enabled. 

In this example, LAT is not enabled: 

enable lat NO 
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lat_service_entries 

lat_service_entries integer 

Specifies the LAT services tables and the number of reserved LAT service 
entries that the network computer can retain. These entries are unavailable until 
the broadcast service advertisement has been received by the network 
computer. LAT is available only to those network computers that have the 
DECnet option enabled. 

Parameters 

integer specifies the number of reserved LAT service entries that the 

network computer can retain. Keep the number of entries as few 
as possible to reduce memory usage. The maximum number of 
entries is 32,767 (default 120). 

In this example, there are 120 reserved LAT service entries: 

lat_service_entries 120 

lat_services_table 

lat_services_table node_name service_name 

Reserves space for LAT services from a particular node that the network 
computer can connect to. The maximum number of entries in the 
lat_services_table is approximately 20. These nodes appear in the HostMenu 
list for LAT entries (refer to the HostMenu topic later in this chapter). 

Parameters 

node_name specifies the node name on which to reserve space. The name can 
be from 1 to 16 characters (any combination of alphanumeric and 
ASCII codes 192-253). 

service_namespecifies the LAT service. The name can be from 1 to 16 

characters (any combination of alphanumeric and ASCII codes 

192-253). 

In this example, the host name is Oregon and the LAT service is oregonl : 

lat_services_table "Oregon" "oregonl" 
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show_lat_services 

show_lat_services YES or NO 

Specifies whether the available LAT services display in the HostMenu client 
and in Tekterm sessions using LLogin (LAT session login). If they do not 
display, they are not available to users. 

Parameters 

YES specifies that the LAT services display and are available to users. 

This is the default. 

NO specifies that the available LAT services do not display. 

In this example, available LAT services do not display in the HostMenu, or in 
Tekterm sessions: 

show lat services NO 
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File Host Configuration 



The network computer searches for the . tbl and other configuration files based 
on the information set up in this section. 

During the boot process, the network computer uses the primary host settings 
to search for the other configuration files. If the files are not found or the 
primary host is not accessible, the secondary settings, if specified, are used. The 
hostname and path formats change, depending on the access method. 

file_access_1 

file_access_l OFF or NFS or TFTP or DAP 

Specifies the access method to connect to the primary host, containing 
configuration files. The host is specified by file_host_name_l . 

Parameters 

OFF specifies that the primary path is not used. This is the default. 

NFS specifies that the connection to the host is through NFS. NFS can 

be used as the file access method to any host running NFS. 

TFTP specifies that the connection to the host is through TFTP. TFTP 

can be used as the file access method for hosts supporting TCP/IP. 

DAP specifies that the connection to the host is through DAP. 

In this example, files are accessed through TFTP: 

file access 1 TFTP 
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file host name 1 



file_host_name_l ip_address or host_name or TDEnet_address or 
TDEnet_nodename 

Specifies the primary host where the network computer obtains configuration 
information, such as a table of font file directories, \ffile_access_l is NFS, the 
file_host_name should be set to null (""). \ifile_access_l is TFTP or DAP, 
enter the host name or IP address (use colon format for DAP; use decimal-dot 
format for TFTP). 

Parameters 

ip_address specifies the IP address of the host, \ifile_access_l is NFS, 

set this to null (""). 

host_name specifies the name of the host. To use a host name, it must 

be specified in an ip_host_table command, stored in 
NVRAM, or Name Service must be enabled on the network 
computer. 

TDEnet_address specifies the TDEnet address of the host. 

TDEnet_nodename specifies the name of the host. To use a host name, it must 
be specified in a tde_host_table command, stored in 
NVRAM, or Name Service must be enabled on the network 
computer. 

In this example, the host is the NFS directory: 

f ile_host_name_l "" 
In this example, the TFTP host directory is montana: 

f ile_host_name_l "montana" 
In this example, the TFTP host is at IP address 128.07.60.02: 

f ile_host_name_l "128 .07.60. 02" 
In this example, the TDEnet host is at node address 1 1.25: 

file host name 1 "11.25::" 
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file_path_1 

file_path_l pathname 

The network computer uses this entry as the directory to search for 
configuration and font files on the primary host. 

Parameters 

pathname specifies the path to the configuration and font files. The default 
path is Aekxp/boot/config for UNIX hosts, or TEK$XP_CONFIG: 
for VMS hosts (unless you change the VMS logicals to point to 
model specific configuration files). 

In this example, the path to the .tbl files is TEK$XP_CONFIG: 

filepathl "TEK$XP_CONFIG:" 

file_access_2, file_host_name_2, file_path_2 

The network computer uses these commands similar to the f ile_access_l, 
f ile_host_name_l, and f ile_path_l commands for the secondary host. 
During the boot process, if the . tbl files are not found on the primary host and 
path, or if the primary host is not accessible, the secondary host and path, if 
specified, are searched. If the files are found, they are accessed according to the 
specified secondary protocol. 

These examples show files accessed through NFS : 

f ile_access_2 NFS 
f ile_host_name_2 "" 
f ile_path_2 " /tekxp/boot/conf ig" 
The previous example assumes that the nfs.tbl contains an entry such as: 

montana : /ul/tekxp /tekxp 



NCBridge Reference Manual 2-23 



53 



Chapter 2 Remote Configuration 

Configuring the X Environment 

This section describes the commands for X environment configuration: 
Command Page 

retain_x_settings 2-25 

backing_store 2-25 

prior_xserver_compatibility 2-26 

dual_display_configuration 2-27 

display _access_table 2-27 

enable_access_control 2-28 

enable_bell_speaker 2-29 

default_visual 2-30 

root_depth 2-32 

host_connect_method 2-33 

default_host_list 2-34 

xdmcp_connect 2-36 

primary _xdmcp_server 2-37 

secondary _xdmcp_server 2-37 

xdmcp_keepalive 2-37 

vms_autologin_transport 2-38 

vms_autologin_tdenet_host 2-38 

vms_autologin_tcpip_host 2-39 

screen_saver 2-40 

enable_xshm 2-41 

enable_xv 2-41 

old_decwin_compatible 2-42 

vendor_string 2-42 

font cache limit 2-43 
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retain_x_settings 

retain_x_settings YES or NO 

The network computer uses this entry to determine if settings are saved when 
the X server resets after the last X client connection to the server closes. 

Parameters 

YES specifies that the X server does not reset when logging out. The 

root window and settings will remain (default). 

NO specifies that the X server discards settings, including root 

window properties and device attributes, and restores default font 
paths. 

In this example, the server saves the settings: 

retain_x_settings YES 

backing store 

backing_store DISABLED or WHENMAPPED or ENABLED or 
ALWAYSWHENMAPPED 

Specifies whether the network computer saves obscured pixels when a window 
is obscured or unmapped. When enabled, the network computer uses this entry 
to request the X server to maintain pixels in portions of client windows that are 
obscured. The advantage of using "ALWAYSWHENMAPPED" is that every 
obscured window pixel is saved in RAM, making window operations faster. 
Keep in mind that this uses RAM resources. 

Parameters 

DISABLED specifies that backing_store is disabled and client requests 

are denied. 

WHENMAPPED specifies that backing_store is enabled and the default 
client request is used except for the Always request. 
WHENMAPPED is used if a client requests Always. 

ENABLED specifies that backing_store is enabled and the default 

client request is used. 
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ALWAYSWHENMAPPED specifies that WHENMAPPED is used if the 

client does not make a request. 

Note: Using WHENMAPPED or ALWAYSWHENMAPPED can use 
considerable network computer memory. 

Table 2-3 shows the effect that each parameter has on client requests. Note that 
the levels of backing store capability increase from lowest to highest. 

Table 2-3 Effect of backing store on Client Request 





Client Requests 


Parameters 


Default 


NotUseful 


WhenMapped 


Always 


DISABLED 


NotUseful 


NotUseful 


NotUseful 


NotUseful 


WHENMAPPED 


NotUseful 


NotUseful 


WhenMapped 


WhenMapped 


ENABLED 


NotUseful 


NotUseful 


WhenMapped 


Always 


ALWAYSWHENMAPPED 


WhenMapped 


WhenMapped 


WhenMapped 


Always 



In this example, the client can request that the X server saves pixels when the 
window is mapped: 

backing_store WHENMAPPED 



prior_xserver_compatibility 

prior_xserver_compatibility YES or NO 

Specifies that the X server reads thefonts.tbl and xhosts.tbl files using the same 
method as was used in Version 8.0 and earlier software. 

Note: It is recommended that you do not use this command. 

Parameters 



YES 



NO 



specifies that the X server reads thefonts.tbl and xhosts.tbl files 
in the same manner as previous versions of the software. 

specifies that default information in thefonts.tbl and xhosts.tbl 
files is saved so that server resets do not require these files to be 
read again. This is the default. 
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dual_display_configuration 

This feature is only available on XP100D, XP400D, and NC400 models that 
have the optional dual monitor card. 

dual_display_configuration HORIZONTAL or VERTICAL or MONOHEAD 

Specifies whether multiple displays are positioned side by side, stacked 
vertically, or whether to use only a single display. 

Parameters 

HORIZONTAL specifies that multiple displays are arranged side by side. 
VERTICAL specifies that multiple displays are stacked vertically. 
MONOHEAD specifies that a single display is used. 
In this example, multiple displays are arranged side by side: 

dual_display_conf iguration HORIZONTAL 

display_access_table 

display _access_table ip_address or ipjiostname or tdenet_address:: or 
tdenet_node:: 

The display access table allows the specified hosts to access the network 
computer. These entries are added to the network computer's display access list. 
Only hosts entered here (or in NVRAM) can access the X server on the network 
computer and open windows or make other changes. Other hosts can be added in 
the xhosts.tbl file if enable _access_control is set to YES. They can access the 
display but cannot change the access table or the state of access control. 

This command requires either an IP address, host name (specify with 
ip_host_table or enable Name Service on the network computer), node address 
followed by double colons (::), or node name followed by double colons (::) 
(specify with tde_host_table). 

Note: If connecting to a VMS host via the HostMenu or 

host_connect_method, and logging in using the DECwindows 
login banner, the log-in host does not have to be listed in the 
display _access Jable (i.e., xhosts.tbl). 
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Note: For VMS hosts that use access control, the host name must be 
defined in the network computer's TDEnet host table (i.e., 
nodes.tbl). If using the DECwindows security window to control 
access to your network computer, the name of the host running 
the session manager must be defined in the network computer. 

Parameters 

ip_address specifies the host's IP address. 

ipjiostname specifies the host's name. 

tdenet_address:: specifies the host's TDEnet address. 

tdenet_node:: specifies the name of the TDEnet host. 

In this example, the display access table contains the hosts oregon and Utah: 

display_access_table "oregon" #TCP/IP name 
display_access_table "Utah::" #DECnet name 

enable_access_control 

enable_access_control YES or NO 

Specifies whether access to the network computer is restricted to the hosts listed 
in the display access table. 

Parameters 

YES specifies that access to the network computer is restricted to hosts 

listed in the display access table. 

NO specifies that access to the network computer is not restricted. 

This is the default. 

In this example, access to the network computer is restricted to the hosts listed 
in the display access table: 

enable access control YES 
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enable_bell_speaker 

enable_bell_speaker YES or NO 

This command specifies whether the X server bell tone is enabled through 
either the optional audio speaker on the XP series or the standard speaker on the 
NC series. By default, a bell tone is always enabled. This command switches 
from the standard speaker to the high quality audio speaker, if installed. By 
using this command, a user can adjust the bell volume, which is not possible 
with the standard speaker. 

The bell is heard through the internal speaker. If the external speakers or 
headphones are plugged into the audio output jack, the bell is heard through the 
attached device. The bell preempts any audio output in progress from the local 
Audio and Digital Video Players. It also preempts audio controls set by audio 
clients, such as volume control, output gain, and mute control. The volume, 
pitch, and duration of the bell are controlled by X applications, for example, the 
xset utility. If the audio card is not installed, this command is ignored and the 
internal bell is used by default. The internal bell is controlled only through the 
xset utility. 

Parameters 

YES specifies that the bell speaker is enabled. 
NO specifies that the bell speaker is disabled. 

In this example, the bell speaker is enabled: 

enable_bell_speaker YES 
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default visual 



default_visual PSEUDOCOLOR or DIRECTCOLOR or STATICCOLOR 
or TRUECOLOR or STATICGRAY or GRAYSCALE 

Specifies the default visual type. See Table 2-4 on page 2-31. The network 
computer uses this entry to determine the class of colormaps used for the root 
window. Typically, it is best to let each network computer use the default by 
leaving this command commented out. Bitonal (grayscale) devices ignore this 
setting. 

Parameters 

PSEUDOCOLOR causes a pixel value to be used as an index into a colormap 
to produce independent RGB values. 

DIRECTCOLOR causes a pixel value to decompose into separate RGB 

subfields. Each subfield separately indexes a colormap for 
the corresponding value. 



STATICCOLOR 



TRUECOLOR 



STATICGRAY 



GRAYSCALE 



causes a pixel value to be used as an index into a colormap 
(that has predefined read-only RGB values) to produce 
independent RGB values. 

causes a pixel value to decompose into separate RGB 
subfields. Each subfield separately indexes a colormap 
(that has predefined read-only RGB values) for the 
corresponding value. 

causes a pixel value to be used as an index into a graymap 
(that has predefined read-only gray values) for the 
corresponding gray value. 

causes a pixel value to index a graymap for the 
corresponding gray value. 



The default is either PSEUDOCOLOR or GRAYSCALE depending on the 
monitor capabilities. 
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Table 2-4 shows that the screen can be color or grayscale, can have a color map 
that is writable or read-only, and can also have a colormap whose indices are 
decomposed into separate RGB pieces (if you are using a color screen). 

Table 2-4 Visual Types 



RGB Type 


Color 


Grayscale 


Read Only 


Read/Write 


Read Only 


Read/Write 


Undecomposed 


Static Color 


Pseudo Color 


Static Gray 


Gray Scale 


Decomposed 


True Color 


Direct Color 







In this example, the visual type is set to DIRECTCOLOR, meaning that the 
default visual colormap is writable and decomposed into separate RGB pieces: 

default visual DIRECTCOLOR 



NCBridge Reference Manual 



2-31 



53 



Chapter 2 Remote Configuration 

root_depth 

root_depth bit_planes 

All NC900 network computers can take advantage of NCBridge's 16-bit plane 
color support as well as any NC200 or NC400 that has the additional 2MB of 
video memory (option V2 or NCFV2). 

When a network computer is configured to operate in 16-bit plane mode, its X 
server exports a 16-bit plane TrueColor or DirectColor visual, so the 
application can display 65,536 colors instead of only 256 colors in 8-bit plane 
mode. That means the user can see better visual effects on applications that can 
take advantage of 16-bit color depth. Running your network computer in 16-bit 
plane mode also eliminates irksome color flashes that occur when multiple 
color-intensive applications run simultaneously. 

Parameters 

bit_planes specifies the bit-depth of the color. 

In this example, the bit plane value is 16 (65,536 colors): 

root_depth 16 # [8 | 16] 

Limitations 

Some clients (host or local) will not work in 16-bit plane mode. For example: 

• The WinDD ICA client requires 8-bit PseudoColor and cannot be used in 16- 
bit plane mode. If you try to launch a WinDD ICA client in 16-bit plane 
mode, the ICA client writes a message to the console stating that it "cannot 
find the PseudoColor visual" and exits. 

• The Vplay client (digital video) is not supported in 16-bit plane mode. 

These are the only local clients that do not work in 16-bit plane mode. 

Another limitation is that there is a trade-off between screen resolution and 
root-depth and the default visual type. The combination of these settings cannot 
exceed the total installed graphics memory. Invalid settings are ignored. 
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host_connect_method 

host_connect_method DISABLED or HOSTMENU or XDMCP_DIRECT or 
XDMCP_INDIRECT or VMS_TDE or VMSJTCP or TELNET or CTERM or 
LAT or SERIALO or SERIAL1 or WINDD 

Specifies the method of connecting to the host. 

Parameters 

DISABLED 



HOSTMENU 



XDMCP DIRECT 



specifies that you must use the Client Launcher to 
invoke a Telnet session on the host. 

specifies that you use the HostMenu client to connect to 
a host. This is the default. 

specifies that XDMCP (X Display Manager Control 
Protocol) can display a login window on the network 
computer, if xdm is running on the host specified with 
the xdmcp_server command, and if XDMCP is 
enabled on the host. 

To use a host name, it must be specified by the 
ip_host_table command, stored in NVRAM, or 
enable Name Service on the network computer. If the 
specified host's address is zero, then the network 
computer broadcasts to the boot host. 

XDMCP_INDIRECT specifies that the network computer broadcasts to a 
name server (if using DNS). 

VMS specifies that DECwindows displays a login window on 

the network computer, if the TDEnet option is installed on 
the host. The transport is set with the 
vms_autologin_transport command, and the host is 
set with vms_autologin_tdenet_host. 

TELNET, CTERM, opens a session window where you can establish 
LAT, SERIALO, connections to a host. Specify one of the available 

SERIAL1, WINDD sessions. 

In this example, the network computer connects to the host via xdmcp_direct: 

host connect method XDMCP DIRECT 
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default host list 



default_host_list XDMCP or VMS_TDE or VMS_TCP or TELNET or 
CTERM or LAT or IBM or WINDD 

Specifies which group of hosts display on the HostMenu client after powering 
on the network computer. 

Parameters 

XDMCP displays the list of available XDMCP servers. 
VMS_TDE displays the list of available VMS TDEnet servers. 
VMS_TCP displays the list of available VMS TCP/IP servers. 
TELNET displays the list of available TELNET servers. 

displays the list of available CTERM servers. 

displays the list of available LAT servers. 



CTERM 

LAT 

IBM 



WINDD 



displays the list of available IBM hosts to which you can connect 
using 3270. 

displays the list of available Windows NT servers. Windows NT 
servers are added with the windd_menu_entry command. 
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XDMCP Security Features 



The XDMCP Direct List feature allows system administrators to better control 
which hosts are available to users. You can specify a list of hosts that respond 
when users boot a network computer, bypassing the HostMenu client. 

To use the XDMCP Direct List feature, use the following xp.cn/commands: 

host connect method XDMCP DIRECT 



xdmcp_connect 
xdmcp_server 



DIRECT 

ip_address or host_name of the host(s) that you want 
the user to use. You can repeat this command, listing as 
many hosts as you wish. List the hosts in priority. The 
first host listed with this command can be saved in 
NVRAM. Subsequent hosts cannot be saved in 
NVRAM. 

When the network computer boots, only the hosts 
specified with this command are queried. The list has 
an implied priority order. For example, when the 
network computer boots, the XDM login banner of the 
highest priority host available displays. 
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xdmcp_connect 

xdmcp_connect BROADCAST or DIRECT or INDIRECT 

Specifies an additional method of connecting to the host specified by 
xdmcp_server using XDMCP. 

Parameters 

BROADCAST specifies that the network computer broadcasts a request for 
XDMCP server(s) to all local hosts. The HostMenu client 
displays a menu of all hosts (running xdm) who responded to 
the request. BROADCAST requires Release 4 (or higher) of 
XI 1 (XI 1R4). This is the default. 

DIRECT specifies that the network computer broadcasts to the host 

specified with the xdmcp_server command. To use a host 
name, it must be specified by the ip_host_table 
command, stored in NVRAM, or enable Name Service on the 
network computer. If the specified host' s address is zero, then 
the network computer broadcasts to the boot host. 

INDIRECT specifies that the network computer broadcasts to a name 
server (if using DNS). 

Notes: //'xdm keeps timing out, you can send keepalive requests by 
setting xdmcpjceepalive to ON. Refer to the 
xdmcp_keepalive command. 

For information about XDMCP security features, refer to the 
XDMCP Security Features topic on page 2-35. 

In this example, the network computer connects directly to the host specified by 
xdmcp_server: 

xdmcp_connect DIRECT 
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primary_xdmcp_server 

primary _xdmcp_server ip_address or hostname 

Specifies the primary XDMCP host by IP address or name. The network 
computer uses this entry as the host to which the network computer connects. 
If domain name service is not enabled and you specify the host by name, you 
must specify the host in the ip_host_table entry. If the xdmcpjconnect method 
is BROADCAST, an entry is not needed in this command. 

Parameters 

ip_address specifies the IP address of the host. 

hostname specifies the name of the host. 

In this example, the network computer connects to the host at IP address 
128.07.60.01: 

primary_xdmcp_server " 12 8 . 7 . 6 . 01 " 

secondary_xdmcp_server 

secondary _xdmcp_server ip_address or hostname 

Specifies the secondary XDMCP host by IP address or name. Similar to 
primary _xdmcp_server previously described. 

xdmcp_keepalive 

xdmcp_keepalive ON or OFF 

The network computer uses this entry to control whether keepalive requests are 
sent to xdm. 

Parameters 

ON specifies that keepalive requests are sent to xdm. 

OFF specifies that no keepalive requests are sent to xdm. This is the 

default. 

In this example, the keepalive requests are not sent to xdm: 

xdmcp_keepalive OFF 
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vms_autologin_transport 

vms_autologin_transport DISABLED or TDENET or TCPIP 

Specifies the network protocol used to display the VMS autologin window. Use 
this if you are using VMS as the host_connect_method. 

Parameters 

DISABLED disables vms_autologin_transport. 
TDENET specifies using the DECnet protocol. 
TCPIP specifies using the TCP/IP network protocol. 

In this example, the network protocol used is TCP/IP: 

vms_autologin_transport TCPIP 

vms_autologin_tdenet_host 

vms_autologin_tdenet_host TDEnet_address or hostname 

Specifies the DECnet host to connect to when using the VMS host connect 
method with TDEnet. 

Parameters 

TDEnet _addr ess specifies the DECnet address of the host. 

hostname specifies the name of the host. 

In this example, the network computer connects to the TDEnet host idaho: 

vms_autologin_tdenet_host "idaho: :" 

Note: To change the autologin feature from one host to a different host, 
specify the new autologin host and then turn the network 
computer off for at least two minutes. When you power up, the 
login window appears for the new host. 
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vms_autologin_tcpip_host 

vms_autologin_tcpip_host ip_address or hostname 

specifies the TCP/IP host to connect to when using the TCP/IP 
host connect method. 

Parameters 

ip_address specifies the IP address of the host. 

hostname specifies the name of the host. 

In this example, the network computer connects to the TCP/IP host oregon: 

vms_autologin_tcpip_host "oregon" 

Note: To change the autologin feature from one host to a different host, 
specify the new autologin host and then turn the network 
computer off for at least two minutes. When you power up, the 
login window appears for the new host. 



NCBridge Reference Manual 2-39 



53 



Chapter 2 Remote Configuration 

screen_saver 

screen_saver ON or OFF or POWERSAVE 

Specifies whether the screen blanks after 10 minutes of keyboard and mouse 
inactivity. You can specify a different duration of inactivity with the xset 
command. 

Note: Some clients override this setting by automatically turning 
screen _saver off and on during their execution. 

Parameters 

ON sets the screen to blank after 10 minutes of inactivity. This is the 

default. The POWERSAVE setting extends the life of the screen 
better than ON. 

OFF turns off the screen blank feature. 

POWERSAVE 

specifies that the Powersave feature takes effect after 10 minutes 
of inactivity. Powersave is an energy-saving feature that has three 
phases: 

Stand by — after 10 minutes of inactivity, the screen blanks and 
returns immediately when a key is pressed. 

Suspend — after the screen has been on Stand by for 10 minutes, 
the screen remains blank and goes into Suspend mode, using less 
energy than in Stand by mode. When a key is pressed, the screen 
display returns after a few moments. 

Off— after the screen has been in Suspend mode for 10 minutes, 
the screen remains blank and goes into Off mode, using minimum 
energy. When a key is pressed, the screen display returns but 
takes longer than in Stand by or Suspend modes. 

Note: The Powersave feature is not available on the XP330 series 

network computer. For power saving features, the monitor must 
be "Energy Star" compatible. 

In this example, the screen blanks after 10 minutes of inactivity: 

screen saver ON 
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Miscellaneous X Settings 



enable_xshm 

enable_xshm 

This command specifies that the X Shared Memory extension is enabled. There 
are no parameters. Issue the command to enable or comment out the command to 
not enable. 

enable_xv 

enable_xv YES or NO 

This enables the XV server extension. It allows you to use any analog or digital 
video client. This includes the local Analog Video Player if the Analog Video 
hardware is present and the local MPEG Video Player if the MPEG Video option 
is present. XV must be enabled to use the Analog Video or MPEG Video Player. 

Parameters 

YES specifies that xv is enabled. This is the default if the Analog Video 

hardware is present. 

NO specifies that xv is not enabled. This is the default if the analog 

video hardware is not present. 

In this example, xv is enabled: 

enable xv YES 
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old_decwin_compatible 

old_decwin_compatible YES or NO 

Older DECwindows clients may expect the X server to only handle bitmap and 
image data in least significant byte (LSB) order, resulting in scrambled images. 
To allow these older clients to work properly, enable old_decwin_compatible . 
If you do not enable this command, older applications may not display 
correctly, for example, DECwrite graphic attributes and objects, and fonts over 
36 points in size. 

Parameters 

YES specifies that older DECwindows clients can be used. 

NO specifies that older DECwindows clients cannot be used. 

In this example, older DECwindows clients are to be used: 

old_decwin_compatible YES 

vendor_string 

vendor_string string 

Use this command only if using a VT200/LK401 keyboard with a DEC system 
(VMS or ULTRIX) running DECwindows applications. Some DECwindows 
applications check the vendor string to determine how the Delete key works on the 
keyboard (delete the character to the left or to the right of the cursor). 

Parameters 

string enter the following string if using a VT200/LK401 keyboard on a 

DEC system with DECwindows applications: 
DECWINDOWS (Compatibility String) NCD, Inc. 

In this example, a VT200/LK401 keyboard is used with a DEC system running 
DECwindows applications: 

vendor_string "DECWINDOWS (Compatibility String) NCD, Inc." 
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font_cache_limit 

font_cache_limit amount 

Specifies the amount of memory (in kilobytes) to allow for font caching. Fonts 
are stored in the font cache even if the client closes. To empty the font cache, 
reset the server, or select the Empty Font Cache option in Setup. For 
information about Setup options, refer to Chapter 3, Setup. 

Note: The font cache is automatically flushed if available memory is 
less than the minimum amount set with the Low Memory 
Indicator. Once memory is available, the font cache can resume 
storing fonts. Refer to the Start and Preload commands for 
information about the Low Memory Indicator. 

Parameters 

amount specifies the amount of memory in kilobytes to allow for font 

caching (from to 99999). For X-window applications, an 
allocation of 500 kbytes is recommended. If only WinDD ICA is 
used, then 50 kbytes is appropriate. 

In this example, the font cache is 50 kilobytes: 

font cache limit 5 
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Boot Configuration 



This section describes the commands within the remote configuration file that 
specify the boot configuration. These commands and their locations are: 

Command Page 

boot_method / boot_method_2 2-45 

boot_host_name / boot_host_name_2 . 2-46 

boot_path / boot_path_2 2-47 

determine_address_from 2-48 

boot_delay 2-49 

verbose_boot_msg 2-49 

enable_boot_interrupt 2-50 

boot_config_type 2-50 

Note: For network computers that boot from ROM, you can specify 
bootp or DHCP as a backup booting strategy. This example 
shows a bootp setting: 

bootjnethod ROM 

boot_host_name2 Set to host running bootp 

determine _address_from NETWORK 
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boot_method / boot_method_2 

boot_method TFTP or NFS or MOP or ROM 

Specifies the network computer boot method. One or two boot methods can be 
specified. If the last boot method tried is NFS, and the mount point fails, the 
network computer tries to boot using TFTP and the current boot path. The 
secondary boot method feature does not apply to MOP. 



Parameters 
TFTP 



specifies that the network computer boots using TFTP. 



NFS [Read size] specifies that the network computer boots using NFS with a 
specified read size. This is the default method to boot network 
computers not equipped with TDEnet or the Flash Memory 
ROM option. The read size can be set to a number between 
128 and 8192 (default is 1024). You may need to experiment 
with setting different read size values for your host. The read 
size you specify is used for all NFS file access as well. For 
most LANs, a record size of 8192 is recommended for fast 
file access. 



MOP 



ROM 



specifies that the network computer boots using MOP. This 
is the default boot method to boot network computers 
equipped with TDEnet. 

specifies that the network computer boots from ROM. This 
is the default method to boot all network computers equipped 
with the Flash Memory option. 



Note: To boot other network computers from a master network 

computer's flash memory, use TFTP as the bootjnethod, specify 
the master's name or address for the bootjtost, and use 
lromlos.<model> (where <model> is the network computer 
model) for the boot_path. The master network computer must be 
enabled with the enable tftpdaemon command. 



In this example, the network computer first tries to boots via NFS. If NFS fails, 
the network computer tries to boot using TFTP: 



boot_ 
boot 



method_ 
method 



NFS 8192 
TFTP 
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boot_host_name / boot_host_name_2 

boot_host_name ip_address or ip_hostname or TDEnet_address or 
TDEnet_nodename 

Specifies the boot host by IP or TDEnet address or name. If Domain Name 
Service is not enabled and you specify the host by IP name, you must specify 
the host in the ip_host_table entry. 

When the boot_method is MOP, the MOP broadcast protocol is used to 
determine the host and you should leave this line commented out. 

Parameters 

ip_address specifies the IP address of the host. 

ipjiostname specifies the name of the host. 

TDEnet _addr ess specifies the TDEnet address of the host. 
TDEnet _nodename specifies the name of the host. 

Note: To boot other network computers from a master network 

computer's flash memory, use TFTPas the bootjnethod, specify 
the master's name or address for the bootjtost, and use 
lromlos.<model> (where <model> is the network computer 
model) for the boot_path. The master network computer must be 
enabled with the enable _tf tpdaemon command. 

In this example, the network computer boots from the host at IP address 
128.07.60.01: 

boot_host_name "128.07.60.01" 

xp_boothost 

When specifying a boot host name, you can use xp_boothost in place of a 
specific name. This acts as a generic host name, using the host from which the 
network computer booted for the current session. Using xp_boothost instead of 
a specific host name allows you to share a single xp.cnf file among several 
network computers that boot from different hosts. To see the xp_boothost 
address used by a network computer, look at the Internet Host Table in Setup. 
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boot_path / boot_path_2 

boot_path string 

Specifies where the boot files reside on the boot host. 

Parameter 

string specifies the path to the boot file. The default path to the boot file varies, 
depending on the network computer model, as shown in Table 2-5 and 
Table 2-6: 

Table 2-5 Default Path to the Boot File for Unix and Windows NT Hosts 



Model 


Default Path to the Boot File 


NC900 


. . . /tekxp/boot/os . 900 


NC200/NC400 


. . . /tekxp/boot/os .500 


XP200/XP350/XP400 


. . . /tekxp/boot/os .350 


XP100D/XP330 


. . . /tekxp/boot/os .330 



Table 2-6 Default Path to the Boot File for VMS Hosts 



Model 



Default Path to the Boot File 



NC900 
NC200/NC400 



TEK$XP_BOOT :NC9 0_OS . SYS 
TEK$XP BOOT:XP5 OS . SYS 



XP 1 00/XP200/XP350/XP400 
XP100D/XP330 



TEK$XP_BOOT:XP350_OS .SYS 
TEK$XP BOOT:XP3 3 OS . SYS 



Note: To boot other network computers from a master network 
computer's flash memory, use TFTP as the hootjnethod, 
specify the master's name or address for the bootjtost, and 
use lromlos.<model> (where <model> is the network computer 
model) for the boot_path. The master network computer must 
be enabled with the enabletf tpdaemon command. 
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In this example, the NC916 path is /tekxp/boot/os. 900: 

boot_path "/tekxp/boot/os . 900" 

Note: If you use secure tftp, do not use the secure directory pathname 
as part of the path when you specify the boot path. The secure 
function automatically prepends the secure directory pathname 
to all the paths. The boot path must be accessed relative to the 
secure directory and must start with a slash (I). For example, to 
specify that the boot path is /tekxp/boot/os.900, you would enter: 
/boot/ 'os .90 
assuming the secure directory is /tekxp. 

determine_address_from 

determine_address_from NETWORK or NVRAM 

Specifies where the network computer gets its IP address. 

Parameters 

NETWORK specifies that the network computer gets its address from the 
network, such as through bootp. If this parameter is specified, 
bootp and/or rarp and/or DHCP must be running on an 
accessible host. If using DECnet, the network computer's 
ethernet (physical) address must be in the DECnet NCP database. 

If booting from ROM, the network computer obtains its address 
from bootp, rarp, or DHCP and continues booting using flash 
memory. 

NVRAM specifies that the network computer gets its address from 
NVRAM. This is the default. 

In this example, the network computer determines its IP address from the 
network: 

det ermine_addres s_f rom NETWORK 

Note: The bootconf ig type commandworks with this commandto 
determine the method used for the network boot process (bootp, 
rarp, or dhcp). 
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boot_delay 

boot_delay DISABLED or RANDOM or seconds 

Specifies whether the network computer waits before requesting boot files to 
avoid overloading the host during a simultaneous boot. A delay is advisable 
when a large number of network computers must boot from the same host at the 
same time, such as in the event of a power failure. 

Parameters 

DISABLED specifies that the network computer does not wait. This is the 
default. 

RANDOM specifies the network computer waits a random time (under 63 
seconds) before trying to boot. The boot delay time is generated 
based on the last two digits in the hardware address (not to exceed 
63 seconds). 

seconds specifies that the network computer waits a specified number of 

seconds before trying to boot. The available range is 1 to 3600 
seconds. This command can be used with the select command 
to boot selected network computers first. 

In this example, the network computer waits 30 seconds before trying to boot: 

boot_delay 3 

verbose_boot_msg 

verbose_boot_msg ENABLED or DISABLED 

Specifies whether the boot monitor displays the boot and configuration file 
names during loading. 

Parameters 

ENABLED specifies that the file names are displayed. This is the default. 

DISABLED specifies that the file names are not displayed. If this command is 
disabled, a series of dots displays in place of the file names. 

In this example, the network computer displays file names as they are loaded: 

verbose_boot_msg ENABLED 
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enable_boot_interrupt 

enable_boot_interrupt YES or NO 

Specifies whether the boot process can be interrupted by a user, or by a system 
administrator only. 

Parameters 

YES specifies that the user can interrupt the boot process with a 

keyboard key press. 

NO specifies that the user cannot interrupt the boot process. This 

allows the system administrator to control the boot parameters. 

In this example, the boot process can not be interrupted by the user: 

enable_boot_interrupt NO 

boot_config_type 

boot_config_type all or none or bootp or rarp or dhcp 

When booting the network computer using TFTP or NFS, this command is used 
to limit the methods that the network computer uses to obtain boot information 
(such as addresses). By default, when booting from the network, bootp and 
rarp are used to determine IP and host addresses. You can use this default, 
select a single method, or disable both methods. 

Parameters 

all specifies that the network computer uses bootp and rarp to obtain 

boot information when booting from the network. This is the default. 

none specifies that neither bootp nor rarp are used when booting. You 

would use this option only when booting from NVRAM. 

bootp the NC uses only bootp to obtain boot information. 

rarp the NC uses only rarp to obtain boot information. 

dhcp the NC uses only dhcp to obtain boot information. To use dhcp, it 

must be available on a host on your network. 

In this example, the NC access addresses using bootp only: 

boot_conf ig_type bootp 
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TCP/IP Configuration 

This section describes the commands for TCP/IP configuration. They are: 
Command Page 

terminal_name 2-52 

subnet_mask 2-52 

broadcast_address 2-52 

enable_broadcasts 2-53 

default_telnet_host 2-54 

name_server_l 2-54 

name_server_2, name_server_3 2-54 

enable_name_service 2-55 

default_domain_suffix 2-55 

dns_retries 2-56 

dns timeout 2-56 
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terminal_name 

terminal_name name 

Specifies the network computer name. A network computer name can be used 
with the select command to allow only a select network computer or group 
of network computers to execute a given command. 

Parameter 

name specifies the name of the network computer. 
In this example, the network computer name is eugene: 

terminal_name "eugene" 

subnet mask 

subnet_mask ip_subnet_mask 

Controls communications access to other hosts within an internet protocol 
network. Setting the subnet mask incorrectly can prevent the network computer 
from properly communicating with other hosts on the network. 

Parameter 

ip_subnet_mask specifies the internet protocol mask. 
In this example, the subnet mask is 255.255.255.0: 
subnet_mask "255.255.255.0" 

broadcast_address 

broadcast_address ip_address 

Specifies the internet protocol address used for broadcasts. 

Parameter 

ip_address specifies the IP address. 

In this example, the broadcast address is set to 128.07.60.255: 

broadcast address "128.07.60.255" 
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enable_broadcasts 

enable_broadcasts YES or NO 

Specifies whether or not the network computer accepts internet protocol 
broadcast packets. Disabling processing so the network computer ignores 
broadcast packets may improve the network performance. 

Note: Some TCP/IP networks fail if you do not enable broadcasts. The 
failure occurs if a host or dynamic router uses broadcast 
messages to acquire the ethernet address of a network computer 
when rebuilding an ARP table. If enable _broadcasts is set to NO, 
the network computer cannot respond to the broadcast request, 
and the network fails. To avoid this situation, either set up one or 
more hosts to provide the network computer ethernet addresses 
by proxy, or leave enable broadcasts set to YES. Another side- 
effect occurs with the ping function. If enable _broadcasts is set 
to NO, the NC200, NC400, andNC900 network computers do not 
respond to ping broadcasts. 

Parameters 

YES specifies that broadcasts are enabled. This is the default. 

NO specifies that broadcasts are not enabled. 

In this example, broadcast packet processing is enabled: 

enable broadcasts YES 
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default_telnet_host 

default_telnet_host ip_address or hostname 

The network computer uses this entry to connect to a specific Telnet host when 
you invoke Telnet from the Client Launcher. If you specify the host by name, 
the host must be specified in either a previous ip_host_table entry or in 
hosts, tbl. 

Parameters 

ip_address specifies the IP address of the host. 

hostname specifies the name of the host. 

In this example, the default Telnet host is oregon: 

def ault_telnet_host "oregon" 

name_server_1 

name_server_l ip_address or hostname 

Specifies the primary host by IP address or host name. To enter a host name, it 
must be in the host table entry. You must be running Domain Name Service 
(DNS) on your host, or specify the hostname in an ip_host_table command 
for the name service settings to have any effect. Three name servers may be 
specified. 

Parameters 

ip_address specifies the IP address of the host. 

hostname specifies the name of the host. 

In this example, the primary host for name service is at IP address 
128.07.06.01: 

name_server_l "128.07.06.01" 

name_server_2, name_server_3 

These provide a backup when the primary name server is unable to respond. 
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enable_name_service 

enable_name_service YES or NO 

Name service is one method to allow a host name to be used in place of an IP 
address. To use name service, you must run Domain Name Service (DNS) on 
your host, or specify the hostname in an ip_host_table command. 

Parameters 

YES specifies that name service is used. 

NO specifies that name service is not used. This is the default. 

In this example, Domain Name Service is used: 

enable_name_service YES 

default_domain_suffix 

default_domain_suffix string 

Specifies the default suffix to be used when a full host name is not specified. 

Note: To use name service, you must run Domain Name Service (DNS) 
on your host. 

Parameter 

string specifies the domain suffix. 

In this example, the default domain suffix is bv.ncd.com: 

default domain suffix "bv.ncd.com" 
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dns_retries 

dns_retries number 

Specifies the number of retries to resolve DNS. 

Note: To use name service, you must run Domain Name Service (DNS) 
on your host. 

Parameter 

number The number of DNS retries. Values are 1 to 16. The default is 4. 
In this example, the DNS retry value is set to 5: 

dns_retries 5 

dns_timeout 

dns_timeout number 

Specifies the maximum time value, in seconds, to use for resolving a DNS entry. 

Note: To use name service, you must run Domain Name Service (DNS) 
on your host. 

Parameter 

number The DNS timeout value. Values are 1 to 16. The default is 4. 
In this example, the dns retry value is set to 5: 

dns timeout 5 
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TDEnet Configuration 



This section describes the commands within the remote configuration file that 
specify the TDEnet configuration. TDEnet is NCD's implementation of the 
DEC environment, DECnet. The associated commands are: 

Command Page 

tdenet_terminal_name 2-57 

tdenet_terminal_address 2-58 

default_cterm_host 2-58 

enable_trigger_reboot 2-59 

trigger_reboot_password 2-59 

tdenet_connect_timer 2-60 

tdenet_hello_timer 2-60 

tdenet_inactivity_timer 2-61 

tdenet_retransmit_limit 2-61 

tdenet_mop_id_timer 2-62 

dec_sme_resetserver 2-62 

tdenet_terminal_name 

tdenet_termina[_nameTDEnet_nodename : : 

Specifies the name of the TDEnet network computer, if used. Specifying a 
name for a network computer can be used with the select command to allow 
only a selected network computer to execute a given command. 

Parameter 

TDEnet _nodename specifies the network computer name. Use double colons 
after the name. 

In this example, the TDEnet network computer name is eugene: 

tdenet_terminal_name "eugene: :" 
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tdenet_terminal_address 

tdenet_terminal_address TDEnet_address:: 

Specifies the network computer's TDEnet address. Specifying a network 
computer's address can be used with the select command to allow only a 
selected network computer to execute a given command. 

Parameter 

TDEnet address specifies the network computer address. Use double colons 
after the address. 

In this example, the network computer address is set to 57.900: 

TDEnet_terminal_address "57.90 0: :" 

default_cterm_host 

default_cterm_host tdenet_address or hostname:: 

Specifies the Cterm host by TDEnet address or name. The network computer 
uses this entry to determine which host to connect to when Cterm is invoked 
from the Client Launcher. If you specify the host by name, the host must be 
specified in the tde_host_table entry. 

Parameters 

tdenet_address specifies the TDEnet address of the host. Use double colons 
after the address. 

hostname specifies the name of the host. 

In this example, the default Cterm host is Utah: 

default cterm host "Utah::" 
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enable_trigger_reboot 

enable_trigger_reboot YES or NO 

Specifies whether the network computer reboots when the NCP TRIGGER 
command is executed from a remote host. This provides a way to reboot the 
network computer from a remote location. The default value is NO. 

Parameters 

YES specifies that a remote host can execute the NCP TRIGGER 

command can reboot the network computer. 

NO specifies that the NCP TRIGGER command can not reboot the 

network computer. This is the default setting. 

In this example, a remote host executing the NCP TRIGGER command can 
reboot the network computer: 

enable_trigger_reboot YES 

trigger_reboot_password 

trigger_reboot_password password 

Specifies the SERVICE PASSWORD parameter used with the NCP TRIGGER 
command. The password should be set on a per node basis rather than for an 
entire group. If an incorrect password is given, a warning displays. This 
command is optional. 

Parameter 

password Enter the password used with the NCP TRIGGER command. The 
password can be from 1 to 16 hexadecimal digits 
(0123456789ABCDEF). The default password is 
0000000000000000. 

In this example, the NCP TRIGGER command password is 
0123456789ADCDEF: 

trigger_reboot_pas sword 01234 56 78 9ABCDEF 



NCBridge Reference Manual 2-59 



53 



Chapter 2 Remote Configuration 

tdenet_connect_timer 

tdenet_connect_timer interval 

Specifies the interval (in seconds) between a TDEnet connection attempt and a 
lack of response from the remote node before the connection attempt is 
discontinued. 

Parameter 

interval specifies the amount of time between TDEnet connection 

attempts before the connection attempts are terminated. The 
available range is from 1 to 32767 seconds (default is 60). When 
attempting to connect to a heavily loaded remote node, the 
interval should be set to a number larger than the default. 

In this example, the connect timer is set to 75 seconds: 

tdenet_connect_timer 75 

tdenet_hello_timer 

tdenet_hello_timer interval 

Specifies the time interval (in seconds) between hello packets. 

Parameter 

interval specifies the interval between hello packets. The available range 

is from 1 to 32767 seconds (default 
is 20). 

In this example, hello packets are sent every 60 seconds: 

tdenet hello timer 60 
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tdenet_inactivity_timer 

tdenet_inactivity_timer interval 

Specifies the inactivity time (in seconds) on an established connection (TDEnet 
logical link) before a keepalive packet is sent to the remote node. 

Parameter 

integer specifies the amount of time between keepalive packets sent to 

the remote node. The available range is from 1 to 32767 seconds 
(default is 60). 

In this example, keepalive packets are sent to the remote node every 100 
seconds: 

tdenet_inactivity_timer 100 

tdenet_retransmit_limit 

tdenet_retransmit_limit integer 

Specifies the number of times a packet requiring acknowledgment is 
transmitted on an established connection (TDEnet logical link) before the 
connection is timed out. 

Parameter 

integer specifies the retransmit limit. The available range is from 1 to 255 

seconds (default is 10). 

In this example, the packet is sent 8 times before it times out: 

tdenet retransmit limit 8 
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tdenet_mop_id_timer 

tdenet_mop_id_timer interval 

Specifies the interval (in seconds) between MOP identification packets sent to 
the node. 

Parameter 

interval specifies the time interval between MOP identification packets. 

The available range is from 1 to 32767 seconds (default is 300). 

In this example, MOP identification packets are sent every 300 seconds: 

tdenet_mop_id_timer 3 00 

dec_sme_resetserver 

dec_sme_resetserver RESET or IGNORE 

When receiving a server reset request from the DEC session manager, this 
command causes the X server to either reset or ignore the reset requests. 

Parameter 

RESET reset the Xserver when a reset server request is issued by the DEC 

session manager. This is the default setting. 

IGNORE ignore reset server requests issued by the DEC session manager. 

In this example, reset server requests from the DEC session manager are 
ignored: 

dec sme resetserver IGNORE 
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Serial Ports Configuration 



This section describes the commands within the remote configuration file that 
specify the serial ports configuration. The Serial Port features are supported 
only on network computers that have serial ports. 

The serial port commands and their locations are: 

Command Page 

data_bits_0 2-64 

stop_bits_0 2-64 

parity _0 2-65 

flow_control_0 2-65 

baud_rate_0 2-66 

tty_abort_session_0 2-66 

delay _rts_signal_0 2-67 

data_bits_l 2-67 

stop_bits_l 2-67 

parity_l 2-67 

flow_control_l 2-67 

baud_rate_l 2-67 

tty_abort_session_l 2-67 

delay _rts_signal_l 2-67 
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data_bits_0 

data bits 7 or 8 



Specifies the number of data bits for Port 0. Set this to match the configuration 
of the host or the connected device. 

Parameters 

7 specifies seven data bits. 

8 specifies eight data bits. This is the default. 
In this example, the number of data bits is set to 8: 

data bits 8 



stop_bits_0 

stop_bits_0 1 or 2 



Specifies the number of stop bits for Port 0. Set this to match the configuration 
of the host or the connected device. 

Parameters 

1 specifies one stop bit. This is the default. 

2 specifies two stop bits. 

In this example, the number of stop bits is set to 1 : 

stop_bits_0 1 
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parity_0 

parity_0 NONE or ODD or EVEN 

Specifies the serial line parity for Port 0. Set this to match the configuration of 
the host or connected device. 

Parameters 

NONE specifies no parity. This is the default. 

ODD specifies odd parity. 

EVEN specifies even parity. 

In this example, the parity is set to EVEN: 

parity_0 EVEN 

flow_control_0 

flow_control_0 NONE or XON/XOFF or CTS/RTS 

Specifies the flow control for Port 0. Set this to match the configuration of the 
host or connected device. 

Parameters 

NONE specifies no flow control. This is the default. 

XON/XOFF specifies XON/XOFF (software) flow control. 

CTS/RTS specifies CTS/RTS (Clear To Send/Ready To Send hardware) 
flow control. 

In this example, flow control is set to CTS/RTS: 

flow control CTS/RTS 
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baud_rate_0 

baud_rate_0 rate 

Specifies the baud rate for Port 0. Set this to match the configuration of the host 
or connected device. 

Parameters 

rate specifies the baud rate. Choices are 57600 (NC200/400/900 series 

only), 38400, 19200, 9600, 4800, 2400, 2000, 1800, 1200, 600, 
300, 150, 134.5 or 75. Note that port 1 supports up to 115200 on 
all NC series. 

Note: On some network computer models, 38400 is incompatible with 
75, 150, 1800, 2000, and 19200. If you set baud _rate_0 to 38400, 
and baud sate _1 to one of the incompatible rates, you cannot 
save the settings. 

In this example, the baud rate is set to 19200: 

baud_rate_0 19200 

tty_abort_session_0 

tty_abort_session_0 YES or NO 

Specifies whether open serial session windows exit or remain open if the serial 
line is physically disconnected from the network computer. This command is 
used for serial port 1 . 

Parameters 

YES specifies that open session windows exit if the serial line is 

disconnected. The sessions must then be restarted once the serial 
line is re-connected. 

NO specifies that open serial session windows remain on the display 

until the serial line is re-connected. They do not have to be 
restarted once the serial line is re-connected. 

In this example, open serial session windows are to remain open if the serial line 
is disconnected: 

tty_abort_session_0 NO 
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delay_rts_signal_0 

delay _rts_signal_0 YES or NO 

Specifies whether the RTS signal is delayed until the serial session is started. 
This command is commonly used if the network computer is used as a console 
with a Digital Analyzer System (DAS). 

Parameters 

YES specifies that the RTS signal is delayed until the serial session 

starts. 

NO specifies that the RTS signal is not delayed and is sent when the 

network computer boots. 

In this example, the RTS signal is not sent until the session starts: 

delay_rts_signal_0 YES 

data_bits_1 

stop_bits_1 

parity_1 

flow_control_1 

baud_rate_1 

tty_abort_session_1 

delay_rts_signal_1 

These commands are similar to the Port commands, except baud_rate 
supports 115200 on NC series computers. 
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Net To Port Configuration 



This section describes the commands within the remote configuration file that 
specify direct serial and parallel port access. Direct port access is available on 
network computers equipped with serial and/or parallel ports. 

The net to port commands are: 

Command Page 

disable_net_to_port 2-68 

enable_net_to_port 2-68 

define_net_port 2-69 

net_to_port_protocol 2-69 

net_to_port_connections .... 2-70 

printer_port_direction 2-70 

disable_net_to_port 

disable_net_to_port 

Disables the net to port access. To disable net to port access, remove the # from 
the beginning of the line. 

enable_net_to_port 

enable_net_to_port LOW_PRIORITY or HIGH_PRIORITY 

Enables net to port access and specifies the rate for processing data to and from 
the port. 

Parameters 

LOW_PRIORITY specifies that data is processed to and from the port at a 
low rate. If on a busy network, use this setting. 

HIGH_PRIORITY specifies that data is processed to and from the port at a 
high rate. 

In this example, net to port is enabled and data is processed at a high rate: 

enable_net_to_port HIGH_PRIORITY 
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define_net_port 

define_net_port SERIAL_PORT_0 or SERIAL_PORT_l or 
PARALLEL_PORT and TCP/IP or TDENET and port number 

Redefines the port number that the net_to_port command listens to. 

Parameters 

SERIAL_PORT_0, 1, specifies the port to redefine. 
PARALLEL_PORT 

TCP/IP, TDENET specifies the port's protocol. 

port number specifies the port's new number. 

In this example, SERIAL_PORT_l's TCP port is to be 34. 

def ine_net_port SERIAL_P0RT_1 TCP/IP 34 

net_to_port_protocol 

net_to_port_protocol SERIAL_PORT_0 or SERIAL_PORT_l 
or PARALLEL_PORT and TCP/IP or TDENET and socket # 

Specifies a port, its network protocol, and the socket number (optional). The 
three ports can be used simultaneously. To set up multiple ports, copy this 
command for each port. 

Parameters 

SERIAL_PORT_0, specifies the port to configure. 

SERIAL_PORT_l, 

PARALLEL_PORT 

TCP/IP specifies that TCP/IP is the network protocol for the specified port. 

TDENET specifies that TDEnet is the network protocol for the specified port. 

socket # (optional) specifies the socket number. Available sockets for TCP/IP 
are 87 and 88 (serial ports) and 89 (parallel port). Sockets for 
TDEnet are 128 and 129 (serial ports) and 130 (parallel port). 

In this example, serial port 1 uses the TCP/IP network protocol on socket no. 88: 

net_to_port_protocol SERIAL_PORT_l TCP/IP 88 
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net_to_port_connections 

net_to_port_connections SERIAL_PORT_0 or SERIAL_PORT_l or 
PARALLEL_PORT and 1 or 2 or 3 or 4 or 5 

Specifies the number of connections that can be queued for a port. Once the 
specified number of connections are queued, any additional attempts are 
ignored. 

Parameters 

SERIAL_PORT_0, specifies the port for which to determine 

SERIAL_PORT_l,the number of connections. 
PARALLEL_PORT 

1, 2, 3, 4, 5 specifies the number of connections allowed in the queue 

for the specified port. 

In this example, 5 connections are allowed for Serial Port 1 : 

net_to_port_connections SERIAL_PORT_l 5 

printer_port_direction 

printer_port_direction AUTOMATIC or UNIDIRECTIONAL or 
BIDIRECTIONAL 

This command configures the printer port. Use the default setting of 
AUTOMATIC unless your printer specifically needs unidirectional support or 
is affected by automatic detection. 

Parameters 

AUTOMATIC Automatically configures the printer port. This is the 

default. 

UNIDIRECTIONALConfigures the printer port for one-way communication 
to the printer. 

BIDIRECTIONAL Configures the printer port for bi-directional 
communication with the printer. 

In this example, the printer port is configured for AUTOMATIC: 

printer_port_direction AUTOMATIC 
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Keyboard and Language Configuration 

This section describes the commands within the remote configuration file that 
specify the keyboard and keyboard language configuration, including the 
language of the Setup messages. These commands are: 

Command Page 

language 2-71 

keyboardjype 2-72 

keyboard_language 2-73 

dp_mode 2-74 

compose_sequences 2-74 

key_map_file 2-75 

keymap_file_list_entry 2-76 

keysym_action_entry 2-77 

keyboard_repeat_rate 2-78 

keyboard_repeat_delay 2-78 

control_alt_delete 2-79 

alt_printscreen 2-79 

language 

language NORTH_AMERICAN or UNITED_KINGDOM or FRENCH or 
SWEDISH or DANISH or NORWEGIAN or GERMAN or ITALIAN or 
SPANISH or SWISS_GERMAN or KATAKANA or FINNISH 

Specifies the language used for Setup fields and messages. 

Parameters 

NORTH_AMERICAN, UNITED_KINGDOM, FRENCH, SWEDISH, 
DANISH, NORWEGIAN, GERMAN, ITALIAN, SPANISH, 
SWISS_GERMAN, KATAKANA, FINNISH specifies the indicated 
language. NORTH_AMERICAN is the default. 
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In this example, Setup fields and messages are displayed in Spanish: 

language SPANISH 



keyboard_type 



keyboard_type 101 or 102 or 101 Pause or 102 Pause or UNIX or 
VT200JJLTRIX or VT200_VMS or VT200_X_ESC or VT200_X_F11 

or 3270 or SUN_V or CUSTOM 

Specifies the keyboard type used on the network computers. 

Parameters 

101 or 102 specifies an IBM 101 or 102 with Setup keyboard. 

101 Pause or 102 Pause 

specifies an IBM 101 or 102 with Pause enhanced 
keyboard. Refer to Table 3-2 in Chapter 3, Setup for a list 
of differences between the 101/102 Setup and the 101/102 
Pause keyboards. This is the default. 

UNIX specifies the UNIX keyboard. The UNIX keyboard 

requires a Boot Monitor version greater than 1 .0 and can be 
used only with the NORTH_AMERICAN keyboard 
language specification. This keyboard emulates a Sun 4 
keyboard. 

Note: VT200 keyboard types imply both VT200 and LK401 types. 

VT200JJLTRIX specifies a VT200/LK401 -compatible keyboard for 
ULTRIX. 

specifies a VT200/LK401 -compatible keyboard for VMS. 

specifies a VT200/LK401 -compatible keyboard for VMS, 
where the Fl 1 key is the ESCAPE key. 

specifies a VT200/LK401 -compatible keyboard for VMS, 
where the Fl 1 key is not the ESCAPE key. 

specifies the 3270 keyboard. 

specifies the Sun V keyboard. 
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VT200_X. 


ESC 


VT200_X. 


Fll 


3270 




SUN V 





keyboard_language 



CUSTOM specifies a custom keyboard (requires the keymap_file 

entry). 

In this example, the keyboard is a VT200 that has the Fl 1 function key being 
used as Fl 1 : 

keyboard_type VT2 0_X_F11 



keyboardjanguage 



keyboardjanguage NORTH_AMERICAN or UNITED_KINGDOM or 
FRENCH or SWEDISH or DANISH or NORWEGIAN or GERMAN or 
ITALIAN or SPANISH or SWISS_GERMAN or KATAKANA or 
FINNISH or FOLLOWS_LANGUAGE 

Specifies the language used on the keyboard. The network computer uses this 
entry to determine the keyboard language mapping. See Appendix B, 
Keyboards, for further information. 

Parameters 

NORTH_AMERICAN, UNITED_KINGDOM, FRENCH, SWEDISH, 
DANISH, NORWEGIAN, GERMAN, ITALIAN, SPANISH, 
SWISS_GERMAN, KATAKANA, FINNISH specifies the language. Keyboard 
language must be set to NORTH_ AMERICAN if using a UNIX keyboard. 

FOLLOWS_LANGUAGE specifies that the keyboard language is the same 
language as that specified by the language command. 

NORTH_AMERICAN is the default. 

In this example, the keyboard language is set by the language entry: 

keyboard_language FOLLOWS_LANGUAGE 
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dp_mode 

dp_mode ON or OFF 

Specifies whether the keyboard is in data-processing mode. The network 
computer uses this entry to determine whether certain keys on the right side of 
keyboards — other than North American — produce special symbols. 

Parameters 

ON specifies that the keyboard is in data-processing mode and 

produces special symbols (on VT200 keyboards). 

OFF specifies that the keyboard is not in data-processing mode and 

does not produce special symbols. This is the default. 

In this example, data-processing mode is disabled: 

dp_mode OFF 

co m pose_seq uences 

compose_sequences YES or NO 

Specifies whether NCD keyboard compose sequences are loaded. Compose 
sequences allow the user to define key press sequences to produce special 
characters, such as foreign letters or symbols, or function shortcuts. For more 
information about compose sequences, refer to Appendix C, CSLIP. 

Parameters 

YES specifies that the compose sequences are loaded. 

NO specifies that the compose sequences are not loaded. 

In this example, the compose sequences are not loaded: 

compose_sequences NO 
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key_map_file 

key_map_f ile filename 

Specifies the key map file used to customize the keyboard. If you have a custom 
keyboard, use this command to specify the keyboard file. 

The key map file is a binary file. 

Note: If the identification number of the keyboard attached to the 
network computer matches one specified in the 
keymapf ilelistentry command, the filename specified 
in the keymapf ilelistentry command is used. Disable 
the keymapf ilelistentry command if necessary. 

Parameter 

filename specifies the custom key map filename. 

In this example, the custom key map file is kb3270na0001: 

key_map_f ile kb3270na0001 
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keymap_file_list_entry 

keymap_file_list_entry filename keyboard ID 

Specifies the custom key map filename associated with a keyboard 
identification number. Specify one filename per keyboard identification 
number. When that identification number is recognized, the associated key map 
file is used. Repeat this command in the xp.cnf file as many times as required to 
assign a key map file to the keyboards for each NC. 

The keyboard ID value can be displayed using the xprop -root command. 

Parameters 

filename specifies the key map filename (up to 14 characters in length) to 
be associated with the keyboard identification number. 

keyboard ID specifies the keyboard identification number. Table 2-7 shows 
common keyboard identification numbers. 

Table 2-7 Keyboard Identification Numbers 



Keyboard Type 


Keyboard Identification 
Number 


101, 102 (all models) 

& Windows95 


0XAB83 


VT200 


0XAB84 


UNIX 


0XABA8 


LK401 


AB84 or AB7F 


SunV 


ACA1 


3270 


0XAB86 
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keysym_action_entry 

keysym_action_entry key sym_name ACTION keyboard_type 

Specifies a key to cause an action on a specified keyboard(s). Currently this 
command specifies which keys invoke the Setup and Launcher clients. 

Parameters 

keysym_name specifies the keysym name of the key used to invoke the 

specified A CTION. Entering zero (0) instead of a keysym name 
disables the A CTION. 

ACTION specifies the action invoked by the keysym value. Currently the 

supported actions are TEKSETUP, LAUNCHER, 
TOUCH_CALIBRATE, and LTPEN_CALIBRATE. 

keyboard_type specifies the keyboard type on which the ACTION is invoked 
by the specified keysym number. The available keyboard types 
are 101/102, VT200/LK401, UNIX, 3270, SUN V, Custom, or 
All. 

In this example, the Fl key on a 101-style keyboard opens Setup: 

keysym_action_entry Fl TEKSETUP 101/102 
In this example, the Setup key opens Setup on all keyboards: 

keysym_action_entry TekLauncher TEKSETUP ALL 

keysym_action_entry LAUNCHER ALL 
In this example, the F2 key opens the Touchscreen Calibration client: 

keysym_action_entry F2 TOUCH_CALIBRATE ALL 
In this example, the F3 key invokes Lightpen calibration: 

keysym_action_entry F3 LTPEN_CALIBRATE ALL 
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keyboard_repeat_rate 

keyboard_repeat_rate <rate> 

Specifies the number of characters per second that the keyboard repeats when 
holding down a key. 

Parameters 

<rate> specifies the keyboard repeat rate. Choices are 2, 3, 4, 5, 6, 7, 8, 

9, 10, 11, 12, 13,15, 16, 17, 18, 20, 22, 24, 27, or 30. 

In this example, the keyboard repeat rate is set to 24: 

keyboard_repeat_rate 24 

keyboard_repeat_delay 

keyboard_repeat_delay 250 or 500 or 750 or 1000 

Specifies the delay time (in milliseconds) between when the first character 
displays after a key press and when it starts repeating. 

Parameters 

250, 500, 750, 1000 specifies the repeat delay rate (in milliseconds). 

In this example, the keyboard repeat delay is set to 500 milliseconds: 

keyboard_repeat_delay 500 
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control_alt_delete 

control_alt_delete REBOOT or SERVER_RESET or DISABLE 

Specifies the action taken when the Control-Alt-Delete keys are pressed. 

Parameters 

REBOOT specifies that the network computer reboots. This is the 

default. 

SERVER_RESET specifies that the server resets. 

DISABLE specifies that Control-Alt-Delete is disabled and nothing 

happens when those keys are pressed. 

In this example, the Control-Alt-Delete keys are disabled: 

control_alt_delete DISABLE 

alt_printscreen 

alt_printscreen REBOOT or SERVER_RESET or DISABLE 

Specifies the action taken when the Alt and Printscreen keys are pressed. 

Parameters 

REBOOT specifies that the network computer reboots. 

SERVER_RESET specifies that the server resets. 

DISABLE specifies that Alt+Printscreen feature is disabled and 

nothing happens when those keys are pressed. 

In this example, pressing the Alt and Printscreen keys causes a reboot: 

alt_printscreen REBOOT 
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Configuring Input Extensions 



This section describes the commands within the remote configuration file that 
specify the touch screen and tablet configuration. The Touch Screen, Tablet, 
and Lightpen features are not available for all network computers. 

The input extension commands are: 

Command Page 

touchSc_Min_X 2-81 

touchSc_Min_Y 2-81 

touchSc_Max_X 2-82 

touchSc_Max_Y 2-82 

touchSc_Down_Threshold. . . 2-82 

touchSc_Up_Threshold 2-83 

touchSc_Jitter 2-83 

tablet_Min_X 2-84 

tablet_Min_Y 2-84 

tablet_Max_X 2-84 

tablet_Max_Y 2-85 

lightpen_Min_X 2-85 

lightpen_Min_Y 2-85 

lightpen_Max_X 2-86 

lightpen_Max_Y 2-86 

enable_lightpen 2-86 

lightpen_Flood 2-87 

input_ext_config_file_0 2-87 

input_ext_config_file_l 2-87 

core_device_type 2-88 

enable_mouse_2 2-89 

enable_ext_hotplug 2-89 

pointer_control 2-90 
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Additionally, commands are provided for dual-head network computers. 

To use the Touch Screen, Tablet, or Lightpen, you must have specified 
TOUCHSCREEN, TABLET, or LIGHTPEN as input devices in the 
core_device_type line. You must also specify the device description file (using 
the input_ext_conf ig_f ile_l command), the hardware connected to the 
network computer, and install the supporting device description files from the 
media. 

Note: When connecting the Touchscreen to the network computer, the 
long cable (9 pin to 9 pin) connects to the Touchscreen. The short 
cable (25 pin to 9 pin) connects to the network computer's serial 
port. 

touchSc_Min_X 

touchSc_Min_X integer 

Specifies the minimum X coordinate value. The network computer uses this 
entry to determine the left edge of the screen. 

Parameter 

integer specifies the minimum X coordinate. The default is 15. 

In this example, the minimum X coordinate value is set to 12: 

touchSc_Min_X 12 

touchSc_Min_Y 

touchSc_Min_Y integer 

Specifies the minimum Y coordinate value. The network computer uses this 
entry to determine the lower edge of the touch screen. 

Parameter 

integer specifies the minimum Y coordinate. The default is 10. 

In this example, the minimum Y coordinate value is set to 12: 

touchSc Min Y 12 
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touchSc_Max_X 

touchSc_Max_X integer 

Specifies the maximum X coordinate value. The network computer uses this 
entry to determine the right edge of the touch screen. 

Parameter 

integer specifies the maximum X coordinate. The default is 210. 

In this example, the maximum X coordinate value is set to 120: 

touchSc_Max_X 12 

touchSc_Max_Y 

touchSc_Max_Y integer 

Specifies the maximum Y coordinate value. The network computer uses this 
entry to determine the upper edge of the touch screen. 

Parameter 

integer specifies the maximum Y coordinate. The default is 150. 

In this example, the maximum Y coordinate value is set to 120: 

touchSc_Max_Y 12 

touchSc_Down_Threshold 

touchSc_Down_Threshold integer 

Specifies the threshold mapped to a down-button press. The threshold value 
determines how hard a user must press the touch screen to register as a button 
press when using Surface Acoustic Wave (SAW) touch screens. 

Parameter 

integer specifies the down threshold (between and 15). The higher the 

number, the harder the user must press the screen. The default is 
6. 

In this example, the down threshold is set to 8: 

touchSc Down Threshold 8 
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touchSc_Up_Threshold 

touchSc_Up_Threshold integer 

Specifies the threshold mapped to an up-button release. The threshold value 
determines what constitutes a button release when using Surface Acoustic 
Wave (SAW) touch screens. 

Parameter 

integer specifies the up threshold (between and 15). A means the user 

must completely break contact with the touchscreen to register a 
release. A 2 registers the release even if the user does not entirely 
break contact. The default is 2. 

Note: Be sure to set touchSc _Up ^Threshold value to be less than the 
touchSc _Down_Threshold value. 

In this example, the up threshold is set to 4: 

touchSc_Up_Threshold 4 

touchSc_Jitter 

touchSc_Jitter integer 

Specifies the touchscreen jitter allowance, in pixels. For example, entering 4 
indicates that a change of less than 5 pixels when touching the screen does not 
cause the cursor to move. 

Parameter 

integer specifies the maximum jitter amount in pixels. 

In this example, a change of less than 7 pixels when touching the screen will not 
move the cursor: 

touchSc Jitter 7 
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tablet_Min_X 

tablet_Min_X integer 

Specifies the left edge boundary of the tablet. 

Parameter 

integer specifies the left edge boundary of the tablet (an integer between 

and 2300). The default is 10. 

In this example, the left edge boundary of the tablet is 10: 

tablet_Min_X 10 

tablet_Min_Y 

tablet_Min_Y integer 

Specifies the upper edge boundary of the tablet. 

Parameter 

integer specifies the upper edge boundary of the table (an integer between 

and 2300). The default is 10. 

In this example, the upper edge boundary of the tablet is 10: 

tablet_Min_Y 10 

tablet_Max_X 

tablet_Max_X integer 

Specifies the right edge boundary of the tablet. 

Parameter 

integer specifies the right edge boundary of the tablet (an integer between 

and 2300). The default is 2300. 

In this example, the right edge boundary of the tablet is 2300: 

tablet Max X 2300 
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tablet_Max_Y 

tablet_Max_Y integer 

Specifies the lower edge boundary of the tablet. 

Parameter 

integer specifies the lower edge boundary of the tablet (an integer 

between and 2300). The default is 2300. 

In this example, the lower edge boundary of the tablet is 2300: 

tablet_Max_Y 23 

lightpen_Min_X 

lightpen_Min_X integer 

Specifies the left edge boundary for the light pen. 

Parameter 

integer specifies the left edge boundary for the lightpen (an integer 

between and 900). The default is 25. 

In this example, the left edge boundary is set to 25: 

lightpen_Min_X 2 5 

lightpen_Min_Y 

lightpen_Min_X integer 

Specifies the upper edge boundary for the light pen. 

Parameter 

integer specifies the upper edge boundary for the light pen (an integer 

between and 900). The default is 50. 

In this example, the upper edge boundary is set to 50: 

lightpen_Min_Y 5 
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lightpen_Max_X 

lightpen_Max_X integer 

Specifies the right edge boundary for the light pen. 

Parameter 

integer specifies the right edge boundary for the light pen (an integer 

between and 900). The default is 665. 

In this example, the right edge boundary is set to 665: 

lightpen_Max_X 665 

lightpen_Max_Y 

lightpen_Max_Y integer 

Specifies the lower edge boundary for the light pen. 

Parameter 

integer specifies the lower edge boundary for the light pen (an integer 

between and 900). The default is 805. 

In this example, the lower edge boundary is set to 805: 

lightpen_Max_Y 8 05 

enablejightpen 

enable_lightpen YES or NO 

Specifies whether the lightpen is enabled. 

Parameters 

YES specifies that the lightpen is enabled. 

NO specifies that the lightpen is not enabled. 

In this example, the lightpen is enabled: 

enable_lightpen YES 
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lightpen_Flood 

lightpen_Flood YES or NO 

Specifies whether the display color is changed from black or opaque to a bright blue 
so the lightpen can register, since it won't work over black or opaque displays. 

Parameters 

YES specifies that the display color is changed to a color that the 

lightpen can register. 

NO specifies that the display color does not change. 

In this example, the lightpen flood feature is turned off: 

lightpen_Flood NO 

input_ext_config_file_0 

input_ext_config_file_0 NO_FILE or ptrTridentSAW or ptrTridentCap or 
ptrTridentCapz or ptrTridentRes or lowTekXPTA or highTekXPTA or 
pointerTekXPTA or ptrAbsTekXPTA or ptrLightPenl or ptrTridentSAW2 
or ptrCarroll or ptrAbsCALCOMP or ptrRelCALCOMP or ptrCustoml or 
ptrCustom2 or ptrCustom3 or ptrCustom4 

Specifies the device description file to use for the input device for port 0. The 
device description files are located in the Aekxp/boot directory for UNIX or 
Windows NT hosts, and TEK$XP_CONFIG: for VMS hosts by default. 

Parameters 

The following device description files can be specified: 

No File Specifies that a device description file is not used 

ptrTridentSAW Used with the Trident Touchscreen 

ptrTridentSAW2 

ptrTridentCap 

ptrTridentCapZ 

ptrTridentRes 

ptrCarroll Used with the Carroll Touchscreen 

lowTekXPTA Used with the XPT/A Graphics Tablet 

highTekXPTA 

pointerTekXPTA 
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ptrAbsTekXPTA 

ptrAbsCALCOMP Used with Calcomp tablets 

ptrRelCALCOMP 

ptrLightPenl Used with the Light Pen 

ptrCustoml Used to create your own device description file 

ptrCustom2 

ptrCustom3 

ptrCustom4 

In this example, highTekXPTA is the device description file for use with the 
XPT/A graphics tablet: 

input_ext_conf ig_f i 1 e_0 highTekXPTA 
The input_ext_conf ig_f ile_l command is used for port 1. 

core_device_type 

core_device_type MOUSE or TABLET or TOUCHSCREEN or LIGHTPEN 

Specifies the input, or pointer device where cursor coordinates are read. You 
can specify up to three input devices (including the default MOUSE.) 

Parameters 

MOUSE specifies that the mouse is an input device. This is the 

default. The mouse is always the primary pointer even if 
other pointers are also specified (unless the mouse is 
removed). 

TABLET specifies that the tablet is an input device. 

TOUCHSCREEN specifies that the touch screen is an input device. 

LIGHTPEN specifies that the Light Pen is an input device. 

Note: In order for either the tablet or the touch screen options to 
function correctly, you must have the specified hardware 
connected to the network computer, and you must install the 
supporting device files from the media. 
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In this example, the primary input device is the MOUSE (by default) and other 
input devices are TABLET and TOUCHSCREEN: 

core_device_type TABLET 
core_device_type TOUCHSCREEN 

enable_mouse_2 

enable_raouse_2 YES 

Specifies that a non-Logitech mouse (or compatible) is used with the network 
computer. The mouse may have three buttons, but only button 1 and button 3 
generate events. To use a non-Logitech mouse, uncomment this command. 

enable_ext_hotplug 

enable_ext_hotplug YES or NO 

This parameter allows hot plugging a moving mouse. 

Note: Enabling this feature can lock up the mouse if you are moving it 
rapidly. 

Parameters 

YES Enable hot plugging of moving mouse. 

NO Disable hot plugging of moving mouse (default). 

In this example, hot plugging is enabled: 

enable_ext_hotplug YES 
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pointer_control 

pointer_control acceleration and threshold 

Controls the pointer parameters for speed and distance moved. For example, 
you can use this command to control the mouse speed and response time when 
moved. This command can be used if the xset m command is not available. 
For additional information about specifying pointer parameters with xset, refer 
to the xset man page, if available. 

Parameters 

acceleration specifies the pointer speed. Enter an integer or a simple fraction. 
For precise pointer movement, specify a slow speed, or small 
number. The default is 2. 

threshold specifies the number of pixels the pointer or mouse must move 
before the acceleration rate takes place. Enter an integer. The 
default is 4. 

In this example, the pointer control acceleration is set to 1 and the threshold is 
set to 3 : 

pointer_control 1 3 

touchScO_Min_X touchScO_Min_Y 

touchScO_Max_X touchScO_Max_Y 

touchScO_Down_Threshold touchScO_Up_Threshold 
touchScO_Jitter 

These commands are similar to the preceding counterparts except that they 
apply to a dual-head (dual monitor) NC. These commands apply to monitor 0. 

touchSc1_Min_X touchSc1_Min_Y 

touchSc1_Max_X touchSc1_Max_Y 

touchSc1_Down_Threshold touchSc1_Up_Threshold 
touchSc1_Jitter 

These commands are similar to the preceding counterparts except that they 
apply to a dual-head (dual monitor) NC. These commands apply to monitor 1. 
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Configuring SNMP 



SNMP is a protocol used by many network tools to manage devices that are 
networked together with TCP/IP. If your site runs an SNMP -based package, 
you can set SNMP traps and community strings in the remote configuration file, 
and take advantage of the remote reboot variable defined in the MIB-II file. For 
detailed information about the MIB-II file, refer to Chapter 6, Setting Up 
SNMP. 

You must specify the host, boot method, and boot path settings; otherwise, the 
network computer cannot read the remote configuration file and cannot enable 
SNMP. 

This section describes the commands within the remote configuration file that 
specify the SNMP configuration. These commands are: 

Command Page 

snmp_trap_list 2-92 

snmp_comm_list 2-93 
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snmp_trap_list 

snmp_trap_list host community _string mask 



Specifies SNMP traps for a host. Table 2-8 lists the available traps by name, 
number, and mask value. If you specify the host by name, you must specify the 
host in the host table entry. 



Table 2-8 SNMP Traps 




Trap Name 


Trap Number 


Trap Mask 


coldStart 





1 



warmStart 1 2 

authenticationFailure 4 16 

Parameters 

host specifies which host receives SNMP traps. 

community _string specifies the SNMP community string of which the 
network computer is a member. 

trapjnask specifies the decimal, octal, or hexadecimal code for 

sending traps to the host where decimal 1 indicates a cold 
start, 2 a warm start, and 16 an authentication failure. Other 
valid masks are the sums of two or more values (3, 17, 18, 
or 19). 

In this example, coldStart and authenticationFailure traps are sent to the host 
oregon using the community string public: 

snmp_trap_list "oregon" public 17 
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snmp_comm_list 

snmp_comm_list host community _string R or RW 

Specifies a host and community string for SNMP GET and SET operations. Use 
the host address 0.0.0.0 to allow access to any host with the specified 
community string. 

Parameters 

host specifies where SNMP SET, GET, and GETNEXT 

operations are performed. For open access, use 0.0.0.0 

community _string specifies the community from which GET, GETNEXT, 
and SET are authorized. 

R restricts the host to read-only (only GET, GETNEXT 

allowed). 

RW specifies that the host may read or write (GET, 

GETNEXT, and SET allowed). 

>» CAUTION: Usingthe host address 0.0.0.0 with RW access allows any hostto 
perform read/write operations on the network computer. 

In this example, all hosts using the community string public have read and write 
access: 

snmp_comm_list "0.0.0.0" public RW 



NCBridge Reference Manual 2-93 



53 



Chapter 2 Remote Configuration 

Token-Ring Interface 

Token-ring is not available on the NC400 and the NC900 series. 

This section describes the mtu command used with Token-Ring networks. 



mtu 



mtu 516 or 1500 or 2052 or 4472 or 8144 or 11407 or 17800 

Specifies the maximum transmission unit (MTU) the network computer will 
use of the Token-Ring interface. The MTU is used to limit the size of datagrams 
and in selecting routes in source-routing bridged networks. 

Parameters 

516, 1500, 2052 specify the size of an information field in a Token-Ring 
44772, 11407, frame (default is 1500). Set this number so that 
17800 it is compatible with your Token-Ring network. 

In this example, the mtu setting is 2052: 

mtu 2052 
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Configuring Local Clients 



start 



This section describes the commands in the Local Clients section of the remote 
configuration file. These commands are: 

Command Page 

start 2-95 

preload 2-109 

start_session 2-111 

Note: Local MWM can be started in the remote configuration file, from Client 
Launcher, or from a UNIX, Windows NT, or VMS host. Starting MWM 
from the host using xpsh is recommended so that the user's home or 
system configuration and resource files can be accessed. Starting MWM 
from the remote configuration file or from Client Launcher accesses only 
the files located in the boot directory's language files (example: 
/tekxp/host/usascii/ or texplbootlspanishl, etc). 



start <client> and YES I NO and -args "args" and/or -envs "environment" 

Used to automatically download and start local clients at boot time. This 
command is independent from the preload command. A client need not be 
preloaded to start with the start command. 

Parameters 

<client> specifies the client to download and start at boot time. Valid clients 
include the following: HTTP, PPP, CLOCK, MWM, 
XPWM, XLOCK, HOSTMENU, SETUP, LAUNCHER, RSHD, 
AUDIO_SERVER, AUDIO_MIXER, AUDIO_PLAYER, 
DIGITAL_VIDEO, ANALOG_VIDEO, LOWMEM, NAVIO, 
NETSCAPE, NETSCAPE_LITE, ROUTE_MGR, 
SSADVT,TEKLOGIN, WINDD, and filename. 

Note: See Table 2-2, Features by Platform Chart, on page 2-8 
regarding the clients that are valid for the supported 
platforms. 
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Note: If a window manager is authorized, such as MWM, it is 
downloaded automatically. If more than one window 
manager is specified with start, the last window manager 
specified is started. 

YES specifies the client is downloaded and started upon booting. If the 

client is closed, it does not remain in memory and must be 
downloaded again to restart. 

NO specifies the client is not downloaded and started. 

-args "args" (optional) specifies arguments that may be set for clients. The 
following clients can take arguments: 

XPWM starts the XP window client. 

CLOCK starts the local clock display client. 

HOSTMENU starts the HOSTMENU client. 

SETUP starts the setup configuration client. 

LAUNCHER starts the launcher client. 

NTP starts the Network Time Protocol client that derives time 
reference from the host. 

XLOCK starts the client that locks the NC window to prevent 
unauthorized use. 

PPP starts the Point-to-Point Protocol client. See page 2-214 for 
more details. 

HTTP runs a local HTTP client on the NC that allows remote 
monitoring and management of the NC by an administrator. 
Using a web browser, the administrator can check the NC's 
configuration settings and make changes, if necessary. 

MWM runs the local Motif Window Manager. 
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AUDIO_SERVER These arguments can be set (default value is 
in parenthesis): 

[ -rate freq]freq is the audio hardware sample rate. Valid values 
are: (8000), 9600, 11025, 16000, 18900, 22050, 32000, 37800, 
44100, and 48000. 

-dgain dB ] dB is the digital audio monitor gain (0). 

-dmute I 1] digital audio monitor mute (0, off). 

-lgain dB ] dB is the line input monitor gain (0). 

-lmute Oil] line input monitor mute (0, off). 

-mboost Oil] microphone boost of +20dB (0, off)- 

-mgain dB ] dB is the microphone monitor gain (0). 

-mmute Oil] microphone monitor mute (1, on). 

-vgain dB ] dB is the video monitor gain (0). 

-vmute Oil] video monitor mute off or on (1, on). 



Notes: Since the audio hardware is standard on the NC900, 
AUDIO _SERVER is automatically downloaded. The 
prevent this, use the command: 

start AUDIOSERVER NO 

On the XP, NC200, and NC400 series, if an audio board option is 
installed, AUDIO _SERVER is automatically downloaded. To 
prevent this, use the command: 

start AUDIOSERVER NO 

AUDIO_PLAYER starts the audio player client. 

AUDIOJVIIXER starts the audio mixer client. 

DIGITAL_VIDEO starts the digital video client. 
(Only available on XP400, NC200, and NC400.) 

ANALOGJVIDEO starts the analog video client. 
(Only available on XP300V and X317CVJ.) 

LOWMEM Minimum amount of network computer memory 
(in kilobytes) required before a low memory warning displays. 
The default is set to the minimum amount of memory needed to 
run this client. Setting the amount of memory to zero (0) disables 
this client. 
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RSHD If you are using a UNIX host and do not have a binary 
version of xpsh for the host, you must either compile the source 
for xpsh or use rsh. Using xpsh is preferred, since additional 
parameters can be set when starting a local client on the network 
computer. 

If you use rsh, then the RSHD daemon must be running on the 
network computer. The RSHD daemon has a security parameter 
that can be configured in the xp.cnf file (see page 2-208). 

NAVIO supports these parameters: 

[-help] shows help message. 

[-version] shows the version number and build date. 

[-display <dpy>] specifies the X server to use. 

[-geometry =WxH+X+Y] sets the position and sizes the 

window. 

[-visual <id-or-number>] determines use of a specific server 

visual. 

[-install] installs a private colormap. 

[-no-install] uses the default colormap. 

[-ncols <N>] when not using -install, sets the maximum number 

of colors to allocate for images. 

[-mono] forces 1 -bit-deep image display. 

[-iconic] starts up iconified. 

[-xrm <resource-spec>] sets a specific X resource. 

[-remote <remote-command>] executes a command in an 

already-running Netscape process. For more info, see 

http://home.netscape.com/newsref/std/x-remote.html 

[-id <window-id>] specifies the id of an X window to which the 

-remote commands should be sent; if unspecified, the first 

window found is used. 

[-raise] specifies whether following -remote commands should 

cause the window to raise itself to the top (this is the default. 

[-noraise] the opposite of -raise: following -remote commands 

does not auto-raise the window. 

Note: Arguments which are not switches are interpreted as 

either files or URLs to be loaded. Most customization can 
be performed through the Options menu. 
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NETSCAPE supports these parameters: 

[-help] shows help message. 

[-version] shows the version number and build date. 

[-display <dpy>] specifies the X server to use. 

[-geometry =WxH+X+Y] sets position and sizes the window. 

[-visual <id-or-number>] determines use of a specific server 

visual. 

[-install] installs a private colormap. 

[-no-install] uses the default colormap. 

[-ncols <N>] when not using -install, set the maximum number of 
colors to allocate for images. 
[-mono] forces 1 -bit-deep image display. 
[-iconic] starts up iconified. 

[-xrm <resource-spec>] sets a specific X resource. 
[-remote <remote-command>] executes a command in an already- 
running Netscape process. For more information, see 
http://home.netscape.com/newsref/std/x-remote.html 
[-id <window-id>] specifies the id of an X window to which the - 
remote commands should be sent; if unspecified, the first window 
found is used. 

[-raise] determines whether following -remote commands should 
cause the window to raise itself to the top (this is the default.) 
[-noraise] the opposite of -raise: following -remote commands does 
not auto-raise the window. 
[-nethelp] Show nethelp. Requires nethelp: URL. 
[-dont-force-window-stacking] Ignores the alwaysraised, 
alwayslowered and z-lock JavaScript window.open() attributes. 
[-no-about-splash] Bypasses the startup license page. 
[-no-session-management] 

[-session-management] Netscape supports session management by 
default. Use these flags to force it on/off. 
[-no-irix-session-management] 

[-irix-session-management] Different platforms deal with session 
management in fundamentally different ways. Use these flags if you 
experience session management problems. IRIX session 
management is on by default only on SGI systems. It is also 
available on other platforms and might work with session managers 
other than the IRIX desktop. 

[-dont-save-geometry-prefs] Doesn't save window geometry for 
session. 
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[-ignore-geometry-prefs] Ignores saved window geometry for 

session. 

[-component-bar] Shows only the Component Bar. 

[-composer] Opens all command-line URLs in Composer. 

[-edit] Same as [-composer]. 

[-messenger] Shows Messenger Mailbox (INBOX). 

[-mail] Same as [-messenger]. 

[-discussions] Shows Collabra Discussions. 

[-news] Same as [-discussions]. 

Note: Arguments which are not switches are interpreted as 
either files or URLs to be loaded. 



NETSCAPE_LITE supports these parameters: 

help] shows help message. 

version] shows the version number and build date. 

display <dpy>] specifies the X server to use. 

geometry =WxH+X+Y] sets position and sizes the window. 

visual <id-or-number>] uses a specific server visual. 

install] installs a private colormap. 

no-install] uses the default colormap. 

ncols <N>] when not using -install, set the maximum number of 
colors to allocate for images. 

mono] forces 1 -bit-deep image display. 

iconic] starts up iconified. 

xrm <resource-spec>] sets a specific X resource. 

remote <remote-command>] executes a command in an 
already-running Netscape process. For more information, see 
http://home.netscape.com/newsref/std/x-remote.html 



id <window-id>] specifies the id of an X window to which the 

remote] commands should be sent; if unspecified, the first 
window found is used. 

raise] determines whether following -remote commands should 
cause the window to raise itself to the top (this is the default.) 

noraise] the opposite of -raise: following -remote commands 
will not auto-raise the window. 

nethelp] Shows nethelp. Requires nethelp: URL. 

dont-force-window-stacking] Ignores the alwaysraised, 
alwayslowered and z-lock JavaScript window.open() attributes. 
[-no-about-splash] Bypasses the startup license page. 
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[-no-session-management] 

[-session-management] Netscape supports session management 

by default. Use these flags to force it on/off. 

[-no-irix-session-management] 

[-irix-session-management] Different platforms deal with 

session management in fundamentally different ways. Use these 

flags if you experience session management problems. IRIX 

session management is on by default only on SGI systems. It is 

also available on other platforms and might work with session 

managers other than the IRIX desktop. 

[-dont-save-geometry-prefs] Doesn't save window geometry for 

session. 

[-ignore-geometry-prefs] Ignores saved window geometry for 

session. 

Notes: For more information on the local browser parameters, 

see Configuring Browser Parameters on page 2-112. 

For information on how to flash the local browser into the 
NC flash memory, see Configuring Flash Memory on 
page 2-139. 

Note: Arguments which are not switches are interpreted as 
either files or URLs to be loaded. 

ROUTE_MGR The route manager enables a site to take 
advantage of multiple routers: if a router fails for longer than the 
TCP connection timeout, the route manager routes traffic to other 
routers to minimize the lost connections. Route manager balances 
the network load among the remaining routers until the down 
router comes back on line. The route manager continues to check 
the status of the down router, and waits until it is up and back at 
normal capacity before rerouting any connections back. The route 
manager is transparent to the user. 

The route manager uses routers specified with the 
gateway_table and gateway_entry remote configuration 
commands, the gateway. tbl file, the bootptab file, and the 
Gateway screen of the Network Tables and Utilities menu in 
Setup. 
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Route manager supports these argument values (ROUTE_MGR - 

args): 

[-R] when present, gateway list is randomized. When omitted, list 

is not randomized. 

[-r <on I off I learn>] specifies Router Information Packet usage. 

On means to use RIP, off to ignore, and learn to store in RIP table. 

[-t <seconds>] specifies RIP timeout in seconds. 

[-g <seconds>] specifies the gateway timeout in seconds. 

[-h <seconds>] specifies the time, in seconds, to keep router out 

of use after it goes down. 

SSADVT This argument allows a customer to display a series of 
GIF images as a screen saver on the network computer. Rather 
than having the network computer screen simply blank after a 
specified period of inactivity, system administrators can now 
display advertisements, corporate-endorsed images, and other 
images of general interest on inactive network computers. In non- 
kiosk systems, system administrators can implement the screen 
saver over an entire network, so that all network computers 
display the same images. 

Note: "Screen savers" do not prolong the life of a monitor. At 
best, a screen saver turns off the video information; this 
prevents images from being burned into the phosphor. 
Screen savers do not turn off the filaments that heat the 
cathode, which is what generally wears out in a monitor 
first. A better way to "save" your screen is to select 
"PowerSave" in the Screen Saver field in Setup's main 
menu. This automatically saves the screen, the cathode, 
the CRT, and electrical energy. 

You can use xp.cnf or xpsh to start the screen saver local client 
ssadvt. Once started for a network computer, you cannot kill or 
override the process without rebooting the network computer. 



2-1 02 NCBridge Reference Manual 



start 



Starting the screen saver with the Arp.cn/file. To start the ssadvt 
client using xp.cnf, add a line similar to this one to your xp.cnf 
file: 

start SSADVT YES -args " -t 600 -c 6 -f 
/home/ssadvt . list" #< [ON | OFF] > 

...where -t indicates the timeout in seconds, -c indicates the cycle 
time in seconds, and -f indicates the NFS -mounted file with the 
list of GIF images to be displayed. 

In this example, when the network computer has been inactive for 
a period equal to ten minutes (600 seconds), the screen saver 
displays the first image in the file /home/ssadvt. list. After a 
minute, the next image in the file is displayed, and so on until the 
end of the file is reached, then it loops to the beginning and starts 
over. If a user "interrupts" the stream of screen saver images, for 
example by moving the mouse, the screen saver resumes with the 
next image in the list during a subsequent ten-minute period of 
inactivity. 

The images in the ssadvt.list file must be GIFs; no other image 
format is supported. If you include a non-GIF image in the file, 
that image does not display. The console should mention the 
status of opening the file ssadvt. list and start displaying a 
different GIF every minute. Here's an example of the list: 

! Do not delete this line. 
/local/GIFS/dilbertll .gif 
/local/GIFS/subliminal3 .gif 
/ local /GIFS/csun. gif 
/local/GIFS/xenal7 .gif 
/local /GIFS /brainwash . gif 
/ local /GIFS/pointy- hair .gif 

WINDD The following arguments can be used with the WinDD ICA client: 

[-cfiles] Lets the WinDD client use a configuration file. 

[ -c ] Auto-connect to the first application server in the 
application server list. If there are no application 
servers in the list, this option is ignored and the client 
window is displayed. 

[ -nc ] Do not invoke auto-connect. (Default) 
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[ -d ] Displays the menu bar and the internal borders. 
(Default) 

[ -nd ] Does not display the menu bar or the internal borders. 
For example, this allows a 1280x1024 WinDD window 
to fully display on a 1280x1024 monitor (minus 
windows manager decorations). 

[ -e ] Enables the Application Server edit field window so 

that users can add application servers to the application 
server list. (Default) 

[ -ne ] Disables the Application Server edit field window so 
that users are not allowed to add application servers to 
the application server list. 

[ -title <character-string>] 

Displays a user-defined title of up to 80 characters 
maximum that appears at the top of the WinDD client 
window. 

[-compress] 

Enables compression of ICA network data to and from 
the WinDD ICA client. 

[-no_compress] 

Disables compression of ICA network data to and 
from the WinDD client. 

[-max_compress_disable n] 

Disables compression for n number of outgoing ICA 
commands from the WinDD client. Defaults to 0, 
which enables all compression. Count setting of 
might "compress" client data larger than its original 
size during start of login session. Settings larger than 
restrict expansion of the client data. 

[-floppy] Allows supported host versions of WinDD to use its 
local floppy drive as a network connected drive for the 
Application Server. Only the first host client to specify 
this option is allowed to use the floppy device. Note: 
this is the default for NCD network computers with 
local floppy drive. 
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[-no_floppy_cache] Disables use of local floppy write cache. 
This is a fail-safe option to ensure the entire file has been updated 
in the event a user suddenly ejects a disk mechanically (when 
disks are ejected via the GUI button, that process flushes the 
cache so no information is lost). 

[-iconic] Displays the WinDD window in icon form at startup. 

[-dec_compat_keysym] Configures the keyboard to be 
compatible with DEC LK401 or VT200 keyboards (sets DELETE 
key=backspace and REMOVE key=delete, etc.). 

[-highjbandwidth] Optimizes NC based on network capacity. If 
used, this parameter decreases packet transmit delay. 

[-init_program] Configures the WinDD client to automatically 
provide username, password, etc. and launches a specific 
application upon startup. 

[-keytransactions_file] <filename> Allows the user to specify a 
key translation file to be used for keymapping, allowing key 
override. 

[-no_text_stipple] Disables the feature that renders text using 
multiple Copy Planes rather than Fill Rectangle on X servers that 
stipple efficiently. 

[-outbuf_delay] <value> This is related to the 
-high_bandwidth parameter except that outbuf _delay 
allows a specific value, in milliseconds, to be specified for delay. For 
low-speed networks, the default value is 100ms and for high-speed 
networks it is 30ms. 

[-version] Displays the WinDD version number on the console. 

[-pplines] Renders graphics using Microsoft's Pixel Perfect line 
rendering. This feature may tend to reduce NC performance and 
is normally not necessary so it is best not to use it unless your 
application requires it. 

[-npplines] Disables Pixel Perfect line rendering (see -pplines). 

[ -geometry <geometry> ] Standard XI 1 geometry option, 
<WidthxHeight+X+Y>. Geometry sizes are limited to the 
following: 
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640 x 480 
800 x 600 
1024 x 768 
1280 x 1024 



[ -h <application server> ] Add the named application server(s) 
to the application server list. Multiple application servers can be 
added to the list by listing them separated by spaces. 

[-help] Displays a brief help list on the available WinDD 
command-line options. 

[-initprog <prog> [-initdir <dir>]] specifies the application to 
execute upon application server login. The login session is 
terminated when the application is terminated. 

Prog specifies the application and can also specify its path (up to 
259 characters) and parameters. The program path and name are 
written consecutively (and not separated by a space) when they 
are both specified in prog. A space separates the program name 
and its parameters. These parameters are program specific and 
can specify program settings or data files to invoke on execution. 

Dir specifies the path of the executable program. 

The following example shows how these options could be used 
for an MS Word application: 

-initprog winword.exe 
-initdir c:\msoffice\winword 

[-keysym_only] specifies that all NCD network computer 
keyboards are supported with keysym translations within WinDD. 

[-local_numlock] specifies that WinDD manages the state of the 
Num_Lock independent of any Xserver support. 

[-no_auto_numlock] specifies that WinDD does not control the 
Num_Lock setting. 

[-login <username> [pass <passwd>] [-domain 
<domainname>]] specifies the application server user account 
login name, login password, and domain. These values are used 
for user account verification. 
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When using a WinDD client and connecting to a WinDD 
application server, your username, password, domain, initial 
program, and initial directory are encrypted as they are sent 
across the network. 

Username, password, domainname , dir, and prog are not 
viewable or changeable from the WinDD configuration window. 

[ -r ] Reconnect to the application server after log off. 

[ -nr ] Does not reconnect to the application server after log 

off. (Default) 

[-version] Displays the WinDD version in use. (If the license is 
8019, this option also prints For evaluation purposes 
only.) 

[-x] Exits the WinDD client upon logging out of, or 

disconnecting from, the application server. 

[-nx] Does not exit the WinDD client upon logging out of, 

or disconnecting from, the application server. 
(Default) 

[-force_xcursor] 

specifies that monochrome pointers within the 
WinDD desktop are to be implemented using X 
cursors. Some monochrome pointers are xor'd with 
the underlying desktop. When this switch is 
specified, it is no longer xor'd, as X cursors do not 
support that mode. 

Note: The force _xcursor feature is intended to compensate for 

workstations that do not have a particularly high performance X 
server. Consider using this option if the pointer flashes when 
move, or poor performance is observed entering text in dialog 
boxes. Using this switch improves user interactivity. The only 
side effect is the pointer is displayed in a single color. 
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filename allows you to start a user-defined client when the network 

computer boots. Specify an executable file. A client created to run 
on the NC400 series network computers should not be started on 
other network computers such as NC900 series. If you use 
network computers from multiple series, or families, use the 
select command's FAMILY parameter to specify which family of 
network computers is to use the client. For example: 

select FAMILY=NC4 start filename YES 

select FAMILY=NC900 start newfile YES 

Refer to the select command for more information about using 
the select command. 

Before adding a file to the xp.cn/file, you may want to test the file 
using xpsh to be sure that it starts correctly. 

# xpsh filename 

-envs "variable" (optional) specifies environment variables that may be set for 
clients. The MWM client can take environment variables. Refer to 
the appropriate man page, located in /tekxp/man by default, for 
information about environment variables. 

In the following examples, the HostMenu and the low memory indicator with a 
memory threshold of 200 kilobytes are downloaded and started upon booting. 

start HOSTMENU YES 

start LOWMEM YES -args "200" 

The following example shows a complete, typical WinDD command-line: 

windd -floppy -h tekl -c -login joeuser -pass joepass 
-initprog winword -initdir c:\msoffice\winword -x 
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preload 



preload <client> and NO I TEMP I PERM and -args and/or -envs 

Used to download clients upon booting. Preloading a client stores the client in 
network computer memory so that it takes less time to start and reduces network 
activity. When the client is closed, depending on the parameter set, it is either 
retained in memory, or is removed from memory. 



Parameters 

<client> 



specifies the client to download and start at boot time. Valid 
clients include HTTP, MWM, XPWM, XLOCK, 
HOSTMENU, SETUP, LAUNCHER, RSHD, 
AUDIO_SERVER, AUDIO_MIXER, AUDIO_PLAYER, 
DIGITAL_VIDEO, ANALOG_VIDEO, LOWMEM, 
NAVIO, NETSCAPE, NETSCAPE_LITE, ROUTE_MGR, 
SSADVT, TEKLOGIN, WINDD or TEEMX or filename. 



Notes: See Table 2-2, Features by Platform Chart, on page 2-8 
regarding the clients that are valid for the supported 
platforms. 

If a window manager is authorized, such as MWM, it is 
downloaded automatically. If more than one window 
manager is specified with the preload command, the last 
window manager specified starts. 

NO specifies that the client is not to be downloaded. This parameter 

could be used when customizing your environment using the 
select command and multiple remote configuration files. 

TEMP specifies that the client is downloaded and after starting and 

closing, is not retained in the network computer's memory. If the 
client is started again, it must first be downloaded. 

PERM specifies that the client is downloaded and after starting and 

closing, remains in the network computer's memory. 

-args "args " (optional) 

specifies arguments that may be set for clients. See the start or 
start_session command section for relevant arguments. 
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-envs "variable" (optional) 

specifies environment variables that may be set for clients. 

The MWM client can take arguments and environment variables. 
Refer to the appropriate man page, located in /tekxp/man by 
default, for information about environmental variables. 

In this example, HostMenu and MWM are preloaded into permanent memory: 

preload HOSTMENU PERM 

preload MWM PERM 
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start session 

start_session <session_client> and -args "args" and/or -envs "environment" 

Used to specify which session clients download and start at boot time. This 
allows you to create a default start-up environment, automatically starting those 
sessions you want. When a session is closed, it does not remain in the network 
computer's memory. 

Parameters 

<session_client> specifies the session client to download and start at boot time. 
Once closed, the client does not remain in memory. (The 
TEK340, TEK3270, and TEK3287 emulators require an 
authorization key.) Session clients include: TEEMX, 
XTERM, TEK340, TEK3270, TEK220, and TEK3287 

-args "args" specifies arguments that may be set for sessions. 

If an XTERM or TEK340 session is specified, -args variables 
must be used in the format "-e protocol" where protocol is 
Telnet, Cterm, TIP, or LLogin (LAT session login). 

For TEK3270 or TEK3287 sessions, -args variables are host 
name or IP address. 

For TEEMX, there are many -args variables. For a comprehensive 
description, refer to the TEEMX CDROM manual. One set of 
variables is the terminal emulation number, as defined here: 

0=VT52 emulation 
1=VT100 emulation 
2=VT200/7 emulation 
3=VT220/8 emulation 
12=IBM3270 emulation 
25=IBM5250 emulation 

-envs "variable" (optional) specifies environment variables that may be set for 

sessions. 

In this example, a Telnet session downloads and starts upon booting the 
network computer: 

start_session XTERM -args "-e telnet" 
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Configuring Browser Parameters 



Browser parameters configure the operation of local Navio, Netscape, or Netscape 
Lite. Navio is Netscape Navigator, version 3. Netscape is Navigator version 4, and 
Netscape Lite is version 4 minus email and newsreader. 

Kiosk Mode 

The browsers may be configured to operate in kiosk mode, which configures the 
NC to launch the browser automatically upon power-up. Kiosk mode provides 
several features, such as the ability to execute without requiring the user to log 
onto a host system. Another feature of the kiosk mode allows configuration of the 
browser with minimum buttons — this provides a simpler user interface. 

Typically, the NC and browser can be configured to load a specified URL at full 
screen (no buttons or URL entry field) and use a touch-screen for navigation. 

You can override the default startup URL setting in kiosk browsers. To set kiosk 
browsers to a default URL, such as Network Computing Devices, Inc., edit the 
preferences.js file in the boot directory as follows: 

user_pref ( "browser . startup . homepage" , "http : //www . ncd . com/" ) 

It is sometimes desirable to operate the browser in kiosk mode even when it is 
started with xpsh. Add this line to your xp.cnf file if you want to force kiosk mode: 

parameter browser_kiosk_enable YES 

Replacing "YES" with "NO" does not force non-kiosk mode operation; rather, 
it tells the browser to check the HOME environment variable to determine 
kiosk mode operation. 

In kiosk mode, the browser's default configuration location is a navio directory 
(for Navio) or .netscape directory (for Netscape/Netscape Lite) under the boot 
directory on the boot host using the boot file access method. If you want to set 
the location to something other than the boot directory or change the host or 
filepath, the default kiosk mode file access parameters can be overridden with 
three commands in the xp.cnf file: 

parameter browser_def ault_f ile_access <access_method> 
parameter browser_def ault_f ile_host <hostname> 
parameter browser_def ault_f ile_path / <file_path> 
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The first of these commands sets the file access method to be used for reading 
browser configuration files when in kiosk mode. The second command sets the 
name or IP address of the host that will provide configuration files when the 
browser runs in kiosk mode. The third command sets the path to a directory in 
which the browser expects to find a navio, netscape, or netscape. lite 
subdirectory. 

Parameters 

<access_method> Choices are NFS, ROM, DAP, TFTP, and NONE. When 
NONE, the browser uses the default boot access method. 

<hostname> If a name is used, it should be one that can be resolved using DNS 
(Domain Name Service) or which appears in the network 
computer's Internet Host table. The generic name xp_boothost 
can be used in cases where the specific name of the boot host is 
not known. If NFS or ROM file access is used, the host name does 
not have to be set, but an NFS mount must be set up in the NFS 
table, and a hostname is required there. 

I<file path> This directory is expected to contain the browser configuration 
files that are typically found in a user's home navio or .netscape 
directory or boot/navio or boot/. netscape directory (shown 
below) as supplied on the install media. 



^^ home. navio 

Navio -! __ 

boot/navio 

home. netscape 



Netscape ._ _ _ 

boot/.netscape 
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Configuring LAT 

This section describes the commands within the remote configuration file that 
specify the LAT configuration. LAT can only be used with network computers 
enabled with the TDEnet option. These commands are: 

Command Page 

show_all_lat_services 2-114 

lat_keepalive_timer 2-115 

lat_connect_timer 2-115 

lat_retransmit_timer 2-115 

lat_circuit_timer 2-116 

lat_retransmission_limit 2-116 

add_lat_group_codes 2-116 

delete_lat_group_codes 2-117 

show_all_lat_services 

show_all_lat_services YES or NO 

In the HostMenu client and in Tekterm sessions using LLogin (LAT session 
login), this command specifies whether to display in the either all available 
LAT services or just the highest rated ones. 

Parameter 

YES Display all LAT services in HostMenu and LLogin Tekterm sessions. 

NO Display only highest-rated LAT services. 

In this example, all LAT services are displayed: 

show all lat services YES 
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lat_keepalive_timer 

lat_keepalive_timer integer 

Specifies the inactivity time (in seconds) on a LAT circuit before a keepalive 
message is sent. 

Parameter 

integer specifies the amount of time between keepalive message. The 

available range is from 10 to 255 seconds (default is 20). For a 
busy network, enter a number larger than the default 20. 

In this example, keepalive messages are sent every 30 seconds: 

lat_keepalive_timer 3 

lat_connect_timer 

lat_connect_timer integer 

Specifies the interval (in seconds) between a connect attempt and a lack of 
response from the service node before the connection attempt is discontinued. 

Parameter 

integer specifies the amount of time between service connection attempts 

before the connection attempts are terminated. The available 
range is from 1 to 255 seconds (default 16). 

In this example, LAT service connection attempts last 25 seconds: 

lat_connect_t imer 25 

lat_retransmit_timer 

lat_retransmit_timer integer 

Specifies the interval (in hundredths of a second) between re-transmission 
attempts before the LAT circuit is considered down. 

Parameter 

integer specifies the amount of time between re-transmission attempts. The 

available range is 100 to 1000 hundreths of a second (default is 200). 

In this example, LAT is set to re-transmit every 2 seconds: 

lat retransmit timer 200 
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lat_circuit_timer 

lat_circuit_timer interval 

Specifies the interval (in milliseconds) between messages sent from the 
network computer to the host. 

Parameters 

interval specifies the interval between messages. The available range is 

from 10 to 200 milliseconds (default is 80). 

In this example, the interval is set to 20 milliseconds: 

lat_circuit_timer 20 

lat_retransmission_limit 

lat_retransmission_limit integer 

Specifies the number of times that the network computer re-transmits a message 
before timing out. 

Parameters 

integer specifies the number of retries. The available range is from 4 to 

20 retries (default is 8). 

In this example, the re-transmission limit is set to 12: 

lat_retransmission_limit 12 

add_lat_group_codes 

add_lat_group_codes integer 

The network computer uses this entry to determine which group codes the network 
computer recognizes. The group codes available are from to 255. You can also 
add a range of group codes as shown in the example for delete _lat_group_codes. 

Parameters 

integer specifies the group code to add. The default is 0. 

In this example, the network computer recognizes the group codes and 2: 

add_lat_group_codes 
add_lat_group_codes 2 
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delete_lat_group_codes 

delete_lat_group_codes integer or integer-integer 

The network computer uses this entry to determine which group codes the 
network computer ignores. The group codes available are from to 255. You 
can delete a range of group codes as shown in the example. 

Parameters 

integer specifies the group code to delete. The default is 0. 

In this example, the network computer ignores the group codes 3 through 10: 

delete_lat_group_codes 3-10 
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Miscellaneous 

This section describes miscellaneous commands you can use with the remote 
configuration file. 

Command Page 

unsupported_features_warnings . .2-118 

save_current_setttings 2-119 

restricted_setup 2-119 

setup_password 2-121 

unsupported_features_warnings 

unsupported_features_warnings ON or OFF 

Specifies whether an error message displays when the network computer 
encounters a valid command that is not supported by the specific model of the 
network computer. This command is useful if you are sharing remote 
configuration files among different models of network computers. 

Parameters 

ON specifies that error messages should display. This is the default. 

OFF specifies that error messages should not display. 

In this example, error messages should display: 

unsupported_f eatures_warnings ON 
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save_current_settings 

Controls whether the configuration read from the remote config file up to this 
point is saved in NVRAM. Remote configuration entries after this point are not 
saved in NVRAM unless another save_current_settings entry is used. 

Note: Use this command sparingly since the EEPROMS used to hold 
the data have a limited, finite write life. Excessive writes can 
cause EEPROM failure. 

Parameters 

None. 

In this example, all current settings are saved: 

save_current_set tings 

restricted_setup 

restricted_setup ON or OFF 

Specifies whether access to many Setup fields is restricted. Access is restricted 
by specifying a password. To use this command, you must add it to the remote 
configuration file. 

Parameters 

ON specifies (with setup password) that access to Setup is restricted. 

OFF specifies that access to Setup is not restricted. This is the default. 

To restrict Setup, add these lines to the remote configuration file: 

restricted_setup ON 
setup_password myPassword 
save_current_set tings 

Use the setup_pas sword command when booting the network computer for 
the first time. After that, to keep the password secure, comment the line out of 
the file, and remove the password. For example: 

restricted_setup ON 

# setup_password ###### 

# save_current_settings 
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Table 2-9 lists the fields not restricted with the restricted_setup 
command. 

Table 2-9 Setup Fields That Are Not Restricted 



Menu 


Submenu 


Fields 


Main 




Language 
Keyboard Type 
Nationality 
Screen Saver 
Reset Server 
Exit Setup 


Configuration 


X Environment 


Retain X Settings 


Summaries 




Backing Store 
Default Visual 
Old DW Compatibility 
Font Cache Limit 
Empty Font Cache 


Statistics 


All 


Update Statistics 




TDEnet 


Clear TDEnet Counters 


All 


All 


Return to Main Menu 
(except if already at the Main 
Menu) 
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setup_password 

setup_password password 

Specifies the password for access to restricted Setup fields. Create a password 
that is not easily guessed. If you forget the password, set it to "" (the empty 
string) to remove the password. To use this command, you must add it to the 
remote configuration file. 

To maintain a secure password: 

1. Set restricted_setup to On. 

2. Add a password using the setup_pas sword command. 

3. Use the save_current_settings command (by removing the #). 

4. Boot the network computers. 

5. Place a # in front of the line containing the password so it is not read by 
subsequent boots. 

6. Remove the password. 

7. Add the # to the line containing the save_current_settings command. 
Parameters 

password specifies the password. 
In this example, the setup password is my$setup: 
setup_password my$setup 
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Including Other Configuration Files 

This section describes commands used for including multiple remote 
configuration files. These commands are: 

Command Page 

include_host_access . . . .2-123 

include 2-124 

You can configure network computers differently by creating different remote 
configuration files and then specifying which network computers are to use 
which configuration file. 

In the following example, the network computer whose address is 132.54.67.98 
uses the remote configuration file xpbob.cnf located on the host 132.62.21.54; 
and the network computer 132.54.67.55 uses the file xpjohn.cnf located on host 
132.44.67.32: 

include_host_access 132.62.21.54 TFTP 

select IPADDR 132.54.67.98 include /usr/new/xpbob . cnf 

include_host_access 132.44.67.32 BOOT_METHOD 

select IPADDR 132.54.67.55 include 
/usr/new/xpj ohn . cnf 

Using the select, include_host_access, and include commands, you 
can easily use multiple configuration files to vary configuration settings. 
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include_host_access 

include_host_access address or hostname and NFS or TFTP or DAP or 
BOOT_METHOD 

Specifies the host and file access method if you are reading a configuration file 
from a host other than the boot host, or using a method other than the saved boot 
method. 

Parameters 

address specifies the host's address on which the configuration file is 

located. Enter either an internet address or a TDEnet address. 

hostname specifies the hostname on which the remote configuration file is 
located. 

NFS specifies NFS as the host file access method for the configuration 

file. You must specify the NFS mount in a previous nf s_table 
command (see the nf s_table command earlier in this chapter). 
Specify this command whenever the subsequent include 
commands use an NFS mount in their path. 

TFTP specifies TFTP as the host file access method for the 

configuration file. 

DAP specifies DAP as the host file access method for the configuration 

file. 

BOOT_METHOD 

specifies that the boot host and boot file access method is used to 
access the configuration file. 

In this example, the host address is 134.62.21.54 and the access method is 
TFTP: 

include_host_access "134.62.21.54" TFTP 
In this example, the access method is NFS: 

include host access "" NFS 
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include 

include filename 



Specifies the name of the remote configuration file that the network computer 
reads in addition to the current configuration file. This command is often used 
as the command in a select command (refer to the select command). 

The network computer looks for the file specified with this command on the 
host specified with the include_host_access command. 

Parameters 

filename specifies the name of the remote configuration file to include. The 
filename must include the full path, as in the example. 

Note: If the file access method is NFS, an nfs_table entry must precede 
the include command in this file (xp.cnf). See the nf stable 
command earlier in this chapter. 

In this example, the file name is /usr/new/xpnew.cnf. 
include "/usr/new/xpnew.cnf" 
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Restricting Configuration Parameters 

This section describes the command used for restricting remote configuration 
file commands to specific network computers. This command is: 



select 



select 



select <qualifier> = <value> <any command> 

Specifies selected network computers to execute a specific remote 
configuration file command. For example, this command could be used with the 
include command to allow access to different remote configuration files. 



Parameters 

qualifier 



ETHER 



value 



specifies the network computer's address or subnet mask. 
Choices are: 

ethernet address, with the numbers separated by colons or 

hyphens 

IPADDR IP address 

TDEADDR DECnet address 

TOKEN Token-Ring address 

LOCAL Locally administered Token-Ring address 

SUBNET IP address mask 

MODEL network computer model 

FAMILY product family (XP400, NC400, etc.) 

TERMINAL network computer address (TDEnet or IP) or name 

TERMINAL_NAME network computer name 

When the qualifier is SUBNET, you can specify a range of 
addresses separated by a hyphen (-). 

specifies the addresses for ETHER, IPADDR, TDEADDR, 
TOKEN, LOCAL, SUBNET, MODEL, FAMILY, 
TERMINAL and TERMINAL NAME. When the qualifier is 
IPADDR or TDEADDR, you can specify a range of 
addresses separated by a hyphen (-), as shown in the third 
example. 



any command specifies a command to execute. 
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In this example, the network computer with DECnet address 57.300 includes 
the configuration file tek$xp_config:xpnew.cnf: 

select TDEADDR=57 . 3 00 include 
" tek$xp_conf ig : xpnew . cnf " 

In this example, all network computers on subnet 134.52.21 use the same 
gateway entry: 

select SUBNET = 134 . 62 .21 .255 gateway_table "0.0.0.0" 
134 .52 .21.1 

In this example, any network computer in the address range of 134.62.21.50 to 
134.62.21.60 includes the configuration file /sierra/xpnew.cnf, where sierra is 
an NFS mount: 

include_host_access "" "NFS" 

select SUBNET=134 . 62 .21 . 50-60 include 

" /sierra/xpnew . cnf " 

In this example, the network computer with Token-Ring address 
10:00:88x0:00:04 includes the configuration file Aekxp/joe.cnf. 

select TOKEN=10 : 00 : 88 :c0 : 00 : 04 include 
" /tekxp/ j oe . cnf " 

In this example, the network computer with locally-administered (LAA) 
address 40:00:00:14:00:15 includes the configuration file 
/tekxp/boot/remotelcfl4: 

select LOCAL=40 : 00 : 00 : 14 : 00 : 15 include 
" /tekxp/boot/remote/cf 14 " 

In this example, all network computers in the address range of 57.120 through 
57.126 have the hostjava at address 57.310 in their TDEnet host table: 

select SUBNET=57 . 120-126 : : tde_host_table 57.310 
j ava 

In this example, two different subnets use the same path for booting and 
accessing fonts: 

include_host_access "134.62.21.67" "tftp" 

select SUBNET=134 .62 .21 .255 include " /bin/NC200/conf ig/ jb . cnf ' 

include_host_access "134.72.3.93" "tftp" 

select SUBNET=134 .72 .3 .255 include " /bin/NC200/conf ig/ab . cnf " 
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Configuring Tek220 and Tek340 



This section describes the commands used to configure the Tek220 and Tek340 
emulators. These commands are: 

Command Page 

tek220_num_col, tek340_num_col 2-128 

tek220_autowrap, tek340_autowrap 2-128 

tek220_rev_video, tek340_rev_video 2-129 

tek220_cursor_style, tek340_cursor_style 2-129 

tek220_emulation, tek340_emulation 2-130 

tek220_dev_attr_resp, tek340_dev_attr_resp 2-131 

tek220_user_features, tek340_user_features 2-131 

tek220_keypad_mode, tek340_keypad_mode 2-132 

tek220_cursor_key_mode, tek340_cursor_key_mode 2-132 

tek220_newline_mode, tek340_newline_mode 2-133 

tek220_autorepeat, tek340_autorepeat 2-133 

tek220_blink_cursor, tek340_blink_cursor 2-134 

tek220_answerback, tek340_answerback 2-134 

tekterm_resource_control 2-135 

tekterm_menubar 2-135 

tek220_reverse_ANSI_colors, tek340_reverse_ANSI_colors. 2-136 
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tek220_num_col, tek340_num_col 

tek220_num_col integer 
tek340_num_col integer 

Specifies the number of columns displayed on the Tek220 and Tek340 
emulators. 

Parameters 

integer specifies 80 or 132 columns to display on the emulator. 

In this example, 80 columns are to display: 

tek22 0_num_col 8 

tek220_autowrap, tek340_autowrap 

tek220_autowrap ENABLE or DISABLE 
tek340_autowrap ENABLE or DISABLE 

Specifies whether the autowrap features is used. 

Parameters 

ENABLE specifies that when a line reaches the last column on the emulator, 
it automatically wraps to the next line. 

DISABLE specifies that a line truncates when it reach the last column. 

In this example, the autowrap feature is enabled: 

tek34 0_autowrap ENABLE 
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tek220_rev_video, tek340_rev_video 

tek220_rev_video NO or YES 
tek340_rev_video NO or YES 

Specifies the color of background and foreground of the emulator. 

Parameters 

NO specifies a white background and black foreground. 

YES specifies a black background and white foreground. 

In this example, reverse video is disabled, so the background is white and the 
foreground is black: 

tek22 0_rev_video NO 

tek220_cursor_style, tek340_cursor_style 

tek220_cursor_style BLOCK or UNDERLINE or OUTLINE 
tek340_cursor_style BLOCK or UNDERLINE or OUTLINE 

Specifies the cursor style, or shape. 

Parameters 

BLOCK specifies that the cursor is a square block. 

UNDERLINE specifies that the cursor is a single underline. 

OUTLINE specifies that the cursor is a hollow square with an outline. 

In this example, the cursor is an underline: 

tek22 0_cursor_style UNDERLINE 
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tek220_emulation, tek340_emulation 

tek220_emulation VT220_8 or VT52 or VT100 or VT220_7 
tek340_emulation VT340_8 or VT52 or VT100 or VT340_7 or TEK4014 

Specifies the type of emulation. 

Parameters 

specifies that the emulator accepts and uses 8-bit characters and 
control sequences. 

specifies that the emulator accepts and uses 8-bit characters and 
control sequences. 

specifies that the emulator accepts VT52 commands only. 

specifies that the emulator accepts VT100 commands 
only. 

specifies that the emulator accepts and uses 7-bit characters and 
control sequences. 

specifies that the emulator accepts and uses 7-bit characters and 
control sequences. 

specifies that the Tek340 emulator accepts only ascii text and 
Tek4014 graphics sequences. 

In this example, the Tek340 emulator is set for VT340_8 operation: 

tek340 emulation VT340 8 



VT220. 


8 


VT340. 


8 


VT52 




VT100 




VT220. 


7 


VT340. 


1 


TEK4014 
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tek220_dev_attr_resp, tek340_dev_attr_resp 

tek220_dev_attr_resp VT220 or VT100 or VT101 or VT102 
tek340_dev_attr_resp VT220 or VT100 or VT101 or VT102 

Specifies the device attribute response that the emulator returns to the host 
(when the host requests the device attribute). 

Parameters 

VT220 specifies a VT220 device. 

VT100 specifies a VT100 device. 

VT101 specifies a VT101 device. 

VT102 specifies a VT102 device. 

In this example, the device is set to VT102: 
tek34 0_dev_attr_resp VT102 

tek220_user_features, tek340_user_features 

tek220_user_features UNLOCKED or LOCKED 
tek340_user_features UNLOCKED or LOCKED 

Specifies whether the applications running on the emulator are able to change 
the emulator's preferences. The preferences include: reverse video, auto repeat, 
tab stops, and keyboard lock. 

Parameters 

UNLOCKED specifies that applications can override the emulator's 
preference settings. 

LOCKED specifies that applications cannot override the emulator's 
preferences. 

In this example, the application cannot change preferences: 

tek220 user features LOCKED 
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tek220_keypad_mode, tek340_keypad_mode 

tek220_keypad_mode NUMERIC or APPLICATION 
tek340_kepad_mode NUMERIC or APPLICATION 

Specifies what the emulator's keypad produces when used. 

Parameters 

NUMERIC specifies that a standard numeric keypad is used. 

APPLICATION specifies that the keypad produces application-specific 
control sequences. 

In this example, a standard keypad is used: 

tek3 4 0_keypad_mode NUMERIC 

tek220_cursor_key_mode, tek340_cursor_key_mode 

tek220_cursor_key_mode CURSOR or APPLICATION 
tek340_cursor_key_mode CURSOR or APPLICATION 

Specifies the cursor return characters. 

Parameters 

CURSOR specifies that standard ANSI cursor control sequences are 

returned. 

APPLICATION specifies that application-specific escape character 
sequences are returned. 

In this example, the cursor key mode is numeric: 

tek22 0_cursor_key_mode CURSOR 
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tek220_newline_mode, tek340_newline_mode 

tek220_newline_mode CR or CRLF 
tek340_newline_mode CR or CRLF 

Specifies what happens when a carriage return is entered. 

Parameters 

CR specifies that a carriage return begins a new line. 

CRLF specifies that a carriage return begins a new line and also enters a 

line feed. 

In this example, a carriage return produces a new line only: 

tek3 4 0_newline_mode CR 

tek220_autorepeat, tek340_autorepeat 

tek220_autorepeat ON or OFF 
tek340_autorepeat ON or OFF 

Specifies whether the auto repeat feature is on or off. When auto repeat is on, 
pressing and holding a key causes that key's character to repeat until you stop 
pressing the key. 

Parameters 

ON specifies that the auto repeat feature is on. 

OFF specifies that the auto repeat feature is off. 

In this example, the auto repeat feature is off: 

tek22 0_autorepeat off 
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tek220_blink_cursor, tek340_blink_cursor 

tek220_blink_cursor YES or NO 
tek340_blink_cursor YES or NO 

Specifies whether the emulator's cursor blinks. 

Parameters 

YES specifies that the cursor blinks. 

NO specifies that the cursor does not blink. 

In this example, the cursor on the Tek220 emulator blinks: 

tek22 0_blink_cursorYES 

tek220_answerback, tek340_answerback 

tek220_answerback string 
tek340_answerback string 

Specifies what the emulator replies to the host when it issues an ENQ (enquire) 
command. 

Parameters 

string specifies what the emulator replies to the ENQ command. The 

default is VT220 for the Tek220 emulator, and VT340 for the 
Tek340 emulator. 

In this example, the Tek340 emulator replies to the ENQ command with the 
network computer name, VT340. 

tek34 answerback "VT34 0" 
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tekterm_resource_control 

tekterm_resource_control YES or NO 

Specifies where the Tek220 and Tek340 emulators find configuration settings 
for the menubar and reverse colors. They can be specified from the emulator's 
resource table, or from the xp.cn/file (if defined). 

Parameters 

YES specifies that the emulators use resource settings for the menubar 

and reverse colors. The settings in the xp.cnf file are ignored. 

NO specifies that the emulators use the settings specified with 

tekterm_menubar and tek22 0_reverse_ANSI_colors or 
tek34 0_reverse_ANSI_colors commands. The resources 
are ignored. This is the default. 

In this example, the Tek220 and Tek340 emulator menubars and reverse colors 
are configured using the commands in the xp.cnf file: 

tekterm_resource_control NO 

tekterm_menubar 

tekterm_menubar ON or OFF 

Specifies whether the emulator has a menubar displayed at the top of the 
Tek220 or Tek340 emulator window. 

Parameters 

ON specifies that a menubar displays at the top of the emulator 

window. This is the default. 

OFF specifies that a menubar does not display at the top of the 

emulator window. 

In this example, a menu bar displays: 

tekterm menubar YES 
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tek220_reverse_ANSI_colors, tek340_reverse_ANSI_colors 

tek220_reverse_ANSI_colors YES or NO 
tek340_reverse_ANSI_colors YES or NO 

Specifies whether the ANSI colors on the Tek220 and Tek340 emulators are 
displayed in reverse- video. 

Parameters 

YES specifies that the ANSI colors are reversed. This is the default. 

NO specifies that the ANSI colors are not reversed. 

In this example, reverse colors are enabled on the Tek340 emulator: 

tek340 reverse ANSI colors YES 
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TekLogin 

jirp.cn/commands for TekLogin 

You can add these commands to your xp.cnf file to affect the TekLogin client. 
(They are not listed in the MASTER_xp.cn/file, but they work if you enter 
them.) 

teklogin_show_sessions_in_launcher [YES |N0] 

teklogin_f orce_f ullscreen_windd [YES |N0] 

teklogin_timeout [SECONDS] 

teklogin_require_login [YES | NO] 

teklogin_save_passwords [YES | NO] 

teklogin_def ault_session [1-8] 

teklogin_close_on_connect [YES | NO] 

ppp_session_name <session name> [1-8] 

ppp_connect_type <type> [1-8] 

ppp_app_hostaddr <IP_address> [1-8] 

ppp_dialup_number <number> [1-8] 

Parameters 

<session name> specifies the name that applies to the associated session 
number [1-8]. 



<type> 



<IPaddress> 
<number> 



this specifies the connection type to be applied to the 
associated session number [1-8]. The type choices are NONE 
(the default value), ICA_HOST, ICA_APP, HOSTMENU, 
SDMCP_DIRECT, and TELNET. If the command 
ppp_app_hostaddr is set, it is used with the <type> parameter. 

specifies the host to be used as port of the ppp_connect_type 
command for an associated session number [1-8]. 

assigns a phone number to the specified session [1-8]. The 
phone number can be up to 15 digits maximum. 
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Black and White Pixel Compatibility 

This section describes the command used for setting black and white pixel 
values. This is typically used in Sun environments. 

black pixel 

black_pixel or 1 

Specifies whether clients use the BlackPixel and WhitePixel values supplied by 
the X server, or the values and 1 to represent the colors black and white. Some 
clients rely on the X server for the black and white pixel values, causing 
graphics or text to be displayed incorrectly. If this happens, use the 
black_pixel command to change the default X server values. Reboot the 
network computer to reflect any changes in the pixel values. 

Note: The def aultvisual command must be set to either 

PSEUDOCOLOR or GRAYSCALE to use the black pixel 
command. 

Parameters 

specifies black pixel value. If black _pixel is set to 0, then is the 
black pixel value, and 1 is the white pixel value. 

1 specifies black pixel value. If black_pixel is set to 1 , then 1 is the 
black pixel value, and is the white pixel value. 

In this example, the black pixel value is set to 1 : 

black_pixel 1 
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Configuring Flash Memory 



For network computers equipped with Flash Memory, you can store the most 
recent version of the NCBridge operating system. Then you can boot the 
network computer from flash memory by setting the boot_method to ROM. 

xp.cnf Commands for Configuring Flash Memory 

The xp. cnf commands are: 

Command Page 

do_flash 2-139 

flash_console 2-140 

flash_do_not_compress 2-140 

flash_feature 2-141 

flash_file 2-160 

update_bootrom 2-160 

do_flash 

do_f lash 

This command instructs the network computer to save current boot configuration 
specified by the f lash_f eature command into flash ROM upon the next boot. 
This command must precede the other flash commands in the remote 
configuration file. After a successful flash, DISABLE the do_f lash command 
and reboot the network computer. The do_f lash command may be disabled by 
commenting it out — simply place a # in front of the command. Information in 
Flash Memory is not valid until the NC is rebooted. 

Note: Reboot the network computer from the network to update flash memory. 
While flashing, the NC is inoperable. If using SNMP, snmpd is inactive 
while flashing is in progress. 

To reflash a single NC, you can use the select command to include a file with 
a set of flash commands specific to the particular NC. 



NCBridge Reference Manual 2-1 39 



53 



Chapter 2 Remote Configuration 

flash console 

flash_console ip_address or DNET_address 

Specifies the network computer or host display on which the final Flash status 
message displays after each network computer updates its flash memory. The 
final status message is FLASH: <address> Update Complete, n bytes 
flashed, n percent capacity (where address is the network computer being 
flashed). This message is displayed in the console of the specified NCD 
network computer. 

If the entry in the f lash_console command is not an NCD network 
computer, enter this command to view flash memory status messages: 

xprop -display <address>:0 -root I grep FLASH 

where address is the address entered in the f lash_console command. 

If nothing is specified in the f lash_console command, the final flash status 
message appears in the Console window of each network computer being 
flashed. Once flash completes, you can view the detailed flash messages on 
each network computer's Console window. 

Parameters 

ip_address specifies the IP address of the network computer or host 

where the final status message displays. 

DNET_address specifies the DECnet address of the network computer or host 
where the final status message displays. 

In this example, the final status message appears on the display whose IP 
address is 134.62.21.54: 

f lash_console "134.62.21.54" 

flash_do_not_com press 

flash_do_not_compress 

Specifies whether files are compressed before they are flashed. By default, files 
to be flashed are first compressed. Flashing uncompressed files speeds up the 
flash process; however, it requires more flash memory. If flash memory is at a 
premium, do not enable this command. 

To flash uncompressed files, enable this command by removing the # from the 
beginning of the line. 
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flash feature 

flash_feature feature 

Specifies which features are to be added to flash ROM when using Flash 
Memory. The network computer includes only those features in flash ROM that 
fit, so if you have specified several features, prioritize them by moving the 
critical ones to the top of the list. 

Note: To estimate the amount of flash ROM needed, add the sizes of the 
files to be flashed and multiply by .40 (40%). If you have enabled 
the f lashdonotcompress command, add the sizes of the 
files and do not multiply by .40. 

Parameters 

feature The features listed in Table 2-10 can be flashed: 

Table 2-10 Flash Features 



Feature 



Files Flashed 



SYSTEM 



Note: 



In order to boot from 
ROM, first the system 
files must be flashed 
into the ROM. Next, 
the NC must be 
rebooted with the 
bmethod command 
set to ROM. 



MWM 



os.<model>, rgb.txt, Xge (XP330 only), fonts.dir, fonts. alias, 
LuB10.pcf.Z, LuRT10.pcf.Z, LuV2NT12. 

pcf.Z, LuV2RT12.pcf.Z, deccurs.pcf.Z, decsess.pcf.Z, fg-22.pcf.Z, 
helvB12.pcf.Z, olcursor.pcf.Z, olgll2.pcf.Z, luBS12.pcf.Z, 
luBS14.pcf.Z, luRS12.pcf.Z, techB14.pcf.Z, tekdw 132. pcf.Z, 
tekdw80.pcf.Z, tdwdhb80.pcf.Z, tdwdht80.pcf.Z, tdwhbl32.pcf.Z, 
tdwhtl32.pcf.Z, terml4_100.pcf.Z, term 14_75 .pcf.Z, 
timR10.pcf.Z, timR24.pcf.Z, Xgel.350 (for monochrome XP350 
network computers), Xge8.350 (for color XP350 network computers), 
snmpd.330, snmpd.350, snmpd.500, and snmpd.900. 

XKeysysmDB, language-specific system.mwmrc and Mwm 



XPWM 
TEKSETUP 



xpwm.300 

setup, language-specific TekSetup 



HOSTMENU 
TELNET 



xbcast, language-specific HostMenu 

tek220.<model>, telnet.<model>, language-specific Tek220 



TELNET340 



tek340.<model>, telnet.<model>, language-specific Tek340 



LLOGIN 



tek220.<model>, llogin.<model>, language-specific Tek220 
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Table 2-10 Flash Features (continued) 


Feature 


Files Flashed 


LLOGIN340 


tek340.<model>, llogin.<model>, language-specific Tek340 


CTERM 


tek220.<model>, cterm.<model>, language-specific Tek220 


CTERM340 


tek340.<model>, cterm.<model>, language-specific Tek340 


TIP 


tek220.<model>, tip.<model>, language-specific Tek220 


TIP340 


tek340.<model>, tip.<model>, language-specific Tek340 


REMOTE_CNF 


xp.cnf and rconf.<model> 


TABLET_CONFIG_FILE 


highTekXPTA, lowTekXPTA, pointerTekXPTA, 
ptrAbsTekXPTA, ptrAbsCALCOMP, ptrRelCALCOMP 


TOUCHSC_CONFIG_FILE 


ptrTridentCap, ptrTridentCapZ, ptrTridentRes, ptrTridentSAW, 
ptrTridentSAW2, ptrCarroll, ptrCustoml, 2, 3, and 4, and 
ptrLightPenl 


TEK3270 


tek3270, language-specific snatext, snatermkey, Tek3270 


TEK3287 


tek3287, language-specific snatext, snatermkey 


TEKLOGIN 


teklogin.300 


LAUNCHER 


launcher, system. launcher 


AUDIO_SERVER 


aserver.350, aserver.500, or aserver.900 


AUDIO_PLAYER 


aplay.350, aplay.500, or aplay.900: language-specific Aplay 


AUDIO_MIXER 


mixer.350, mixer.500, or mixer.900: language-specific audio_mixer 


AUDIO_BELL_SPEAKER 


audbelld.350, audbelld.500, or audbelld.900 


DIGITAL_VIDEO 


vplay.350, vplay.500, or vplay.900 

If you have hardware MPEG, then xv and cl480.uc are also flashed. 


ANALOG. VIDEO 


xpvideo.350, xv.350 


LOCAL_XLOCK 


xlock 


FONTS 


contents of the directories specified in the fonts.tbl file (found in 
primary or secondary paths) 
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Table 2-10 Flash Features (continued) 



Feature 


Files Flashed 


BOOTJVIONITOR 


Filename Platform 
boot_mon.330 XP330 series 
boot_mon.350 All other XP series 
boot_mon.500 NC200/NC400 series 
boot_mon.900 NC900 


BOOT_MONITOR_ETHERNET 


Filename Platform 
boot_mon.330 XP330 series 
boot_mon.350 All other XP series 
boot_mon.500 NC200/NC400 series 
boot_mon.900 NC900 series 


BOOT_MONITOR_TOKEN_RING 


Filename Platform 
boot_mon-tr.350 XP series 
boot_mon-tr.500 NC200/NC400 series 


TFTPD 


tftpd.<model> 


PRINT_SPOOLER 


lpd.300 


NET_TO_PORT 


net_to_prt.300 


ROUTE_MANAGER 


route_mgr.300 


WINDD 


windd.300, language-specific WinDD 


FLOPPY_DISK 


fdDrv.350, fdDrv.500, or fdDrv.900 


RSHD 


rshd.300 


CSLIP 


cslip.300 


SLANG 


slang. 350, slang.500, or slang.900 


TEEMX 


teemx.300 

config/teemx320.nv 

locale/locale. alias 

locale/locale. dir 

locale/iso8859-l/Compose 

XKeysymDB 

various IBN and TIS fonts 


NTP 


xtpd.300, config/ntp.conf 


CLOCK 


clock.300 


SSADVT 


ssadvt.300 



NCBridge Reference Manual 



2-143 



53 



Chapter 2 Remote Configuration 



Table 2-10 Flash Features (continued) 



Feature 



Files Flashed 



PPPD 



pppd.300 
config/pap-secrets 
config/chap- secrets 



NAVIO CONFIG FILES 



config/plugins.tbl 

navio/bookmarks .html 

navio/cookies 

navio/signature 

navio/history.db 

navio/preferences 

navio/cert5.db 

navio/key.db 

navio/proxyconf 

navio/mime.types 

navio/mailcap 



a list of available plugins 
default bookmarks list 
default cookies 
default signature 
default browser history 
default config. preferences 
default security certificates 
default security auth. keys 
default proxy configuration 
default app./extension bindings 
default helper app bindings 
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Table 2-10 Flash Features (continued) 
Feature 



Files Flashed 



NAVIO (Netscape 3.0 Browser) navio 

java_301 
XKeysmDB 



locale/compose_dir 
locale/iso8859-l/XLC_LOCALE 
locale/iso8859-l/Compose 
locale/j a/XLC_LOC ALE 
locale/locale. alias 
locale/locale.dir 

navio. 300 

plugins/advtguiplg.300 

plugins/bitmaps/begin.xbm 

plugins/bitmaps/fast_left.xbm 

plugins/bitmaps/fast_right.xbm 

plugins/bitmaps/right.xbm 

plugins/bitmaps/sound.xbm 

plugins/bitmaps/stop.xbm 

plugins/videoplg.300 

plugins/winddplg.300 



Navio browser library 
Java classes 
key binding defaults 
Internationaliztion config files 



Navio browser executable 
Spotlight video advertiser plug-in 
Bititmaps for video plug-ins 



mpeg video plug-in 
WinDD client plug-in 



NETSCAPE CONFIG FILES 



config/plugins .tbl 
netscape/bookmarks. html 
netscape/signature 
netscape/history.db 
netscape/preferences 
netscape/cert7 .db 
netscape/key 3 .db 
netscape/mime.types 
netscape/mailcap 



a list of available plugins 
default bookmarks list 
default signature 
default browser history 
default config. preferences 
default security certificates 
default security auth. keys 
default app./extension bindings 
default helper app bindings 
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Table 2-10 Flash Features (continued) 
Feature 



Files Flashed 



NETSCAPE or NETSCAPE LITE 



netscape_lite 



ifcll.jar 

iioplO.jar 

jae40.jar 

java40.jar 

jio40.jar 

isdlO.jar 

idaplO.jar 

marimblO.jar 

scdlO.jar 

XKeysmDB 

locale/compose_dir 
locale/iso8859-l/XLC_LOCALE 
locale/iso8859-l/Compose 
locale/j a/XLC_LOC ALE 
locale/locale. alias 
locale/locale. dir 

plugins/advtguiplg.300 

plugins/bitmaps/begin.xbm 

plugins/bitmaps/fast_left.xbm 

plugins/bitmaps/fast_right.xbm 

plugins/bitmaps/right.xbm 

plugins/bitmaps/sound.xbm 

plugins/bitmaps/stop.xbm 

plugins/videoplg . 300 

plugins/winddplg.300 



Netscape 4.0 binary minus mail 
and news 

Java class archive 



key binding defaults 
Internationaliztion config files 



Spotlight video advertiser plug-in 
Bititmaps for video plug-ins 



mpeg video plug-in 
WinDD client plug-in 
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Managing the Boot Monitor and Flash Memory 

This topic explains how to configure, update, or modify the contents of the 
Flash ROM and how to boot up from Flash. It also explains how to set up the 
xp.cn/" file to control: 

• Writing and configuring the Flash Memory. 

• Updating the Boot Monitor. 

Basics of the Boot Monitor 

The Boot Monitor (also called the Boot ROM) in a network computer (NC) is 
very similar to the BIOS ROM in a personal computer (PC). The Boot Monitor 
controls the NC and enables it to boot its operating system; that is, the 
NCBridge software. The NCBridge software is loaded into RAM memory at 
boot time from the local Flash ROM or from a host over a network. 

The Boot Monitor includes commands to control the initial booting of the NC. 
The Boot Monitor and Flash ROM are separate parts. The Flash ROM is a plug- 
in option while the Boot Monitor is standard in the NC. Updates to the Boot 
Monitor and Flash ROM occur independently of each other. However, these 
updates are initiated by the same do_flash command in the xp.cnf file. The 
flash_feature command, along with the do_flash command, control which 
Flash part is updated. 
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Flashing the Boot Monitor 

Open the xp. cnf configuration file. Search for the string do_flash and read the 
topic titled xp. cnf Commands for Configuring Flash Memory on page 2-139. 

To update the Boot Monitor, follow this procedure: 

1 . To force an update of the Boot Monitor in an NC, edit your configuration file 
and uncomment or add the two lines below. 

do_f lash 

flash_feature BOOT_MONITOR 

2. Reboot the NC. This causes an update of the Boot Monitor with the version 
associated with the boot file /. . ./tekxp/boot/boot_mon. 900. Each time you 
update the NCBridge version, an updated version of the Boot Monitor is 
included. 

After the NC downloads the boot files, the installation program displays a 
window indicating an update of the Boot Monitor is in progress. A warning 
message appears that says do not power off the NC. 

3. Edit your configuration file and comment out the do_flash and 
flash_feature lines as shown below. This will prevent a reflash of any other 
terminal booting from the same software. 

#do_flash 

#f lash_feature BOOT_MONITOR 

4. To verify the new Boot Monitor is present, reboot the NC and before it 
begins to load the boot files, press Spacebar to stop the boot process. At the 
Boot Monitor screen, check for the new version in the upper left corner of 
the screen. 
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Updating the Flash Memory 

The Flash ROM option in the NC provides the ability for the NC to boot locally 
without requiring a host on the network to boot from. This is a recommended 
solution when the NC will be connected via a low speed network connection 
such as ISDN line or 256K Tl. Booting from a host over this connection may 
take up to 15 minutes. To update the local Flash ROM, the NC must be 
connected via a network and NCBridge is required on a networked host. The 
files will be downloaded from the host and written into Flash memory during 
the boot cycle. The flash process erases the contents and writes a new 
configuration each time. It is not capable of updating individual components. 

The do_flash command in the configuration file controls when the NC will 
update its Flash memory. The flash_feature command identifies which boot 
files are written to Flash memory. The flash features identify groups of boot and 
configuration files. For example, if you need to use PPP to make a TCP/IP 
connection over a modem/serial connection, uncomment the 
#f lash_f eature PPP line (remove the #) to flash all the necessary files 
needed to support PPP. 

The configuration file (see the xp_cnf.txt file topic on page 2-6) contains a list 
of all the flash features. The flash features put into flash memory are primarily 
determined by the required functions needed by the user or administrator using 
the NC. The flash feature "SYSTEM" includes the main boot files where all 
other features are optional. 

Recommended minimum Flash features: 

flash_feature SYSTEM 

f lash_feature XPWM 

f lash_feature TEKSETUP 

f lash_feature TEKHOSTMENU 

flash_f eature TELNET 

f lash_feature REMOTE_CNF 

flash feature LAUNCHER 
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Configuration Scenario 

• The NC needs to be connected at a remote location via an ISDN network. 

• There are multiple Unix hosts and a Terminal Server host at the other end of 
the ISDN network. 

• The user must be able to select from a chooser list and connect via XDM to 
Unix hosts. 

• The local ICA client needs to make a connection to the Windows 
NT 4.0/2000 Terminal Server. 

• A local printer needs to be attached to the NC so users can print from Unix 
and Windows NT. 

• The NC must be configurable from a central configuration file located on a 
Unix host. 

1. Open the xp.cn/ configuration file and search for the string dojlash. In the 
flash section of the configuration file, uncomment (remove the #) the 
dojlash line and the flash Jeatures lines listed below. 

flash_feature SYSTEM 

f lash_feature WINDD 

f lash_feature TEKSETUP 

f lash_feature TEKHOSTMENU 

f lash_feature PRINT_SPOOLER 

f lash_feature REMOTE_CNF 

f lash_feature LAUNCHER 

2. Search in the configuration file for console _pages, uncomment the line and 
increase the value to 16. This provides more buffer space in the Console 
window when viewing flash results. 

3. Reboot the NC so it reflashes the Flash ROM with the new configuration — 
this takes about five minutes. 
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4. When the flash process is finished, open the Console window to see a full list 
of files which have been written to the flash memory. 

If you receive an error indicating that the flash failed, scroll back through the 
console messages and determine which file could not be found. Make a note 
of the filename and determine whether this file is required. 

If the flash process was successful, edit the xp.cn/ file and comment out the 
do_flash and flash_feature commands by placing a "#" in front of each line. 

5. Reboot the NC. Stop the boot process by pressing the Spacebar. You should 
get a boot > prompt. At the boot prompt, enter these commands: 

boot > BM ROM 

boot > NVS 

boot > B 

The NC will now boot from its flash ROM memory. 
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Setting Up the Fonts Directory 

For best performance, limit the number of paths included in thefonts.tbl file. To 
store only specific fonts in ROM, create a new directory and copy those fonts 
that you want to the new directory. Then run mkfontdir to create afonts.dir 
file. Edit thefonts.tbl file to include only the path to the new fonts.dir file. For 
details on setting up fonts, refer to the Setting Up Fonts chapter in your NCD 
NCBridge Installation and Configuration manual. 

Example 2-3 Excerpted xp.cnf File with Some Flash Features Enabled 

do_f lash 

# 

## To flash any or all of the following features, 

## remove the "#" from the beginning of each 

## appropriate line. 

## 

## WARNING! ! Each NC will flash as much as it can, 

## given the size of the EEPROM installed (8MB or 16MB) . 

## Prioritize the list of files you want flashed by 

## placing the most important feature first. 

f lash_feature NAVIO 

f lash_feature NAVIO_CONFIG_FILES 

f lash_feature SYSTEM 

f lash_feature TEKSETUP 

# f lash_feature HOSTMENU 

f lash_feature REMOTE_CNF 

# flash_feature TABLET_CONFIG_FILE 
f lash_feature LAUNCHER 

f lash_f eature FONTS # as specified in fonts. tbl 

f lash_feature BOOT_MONITOR # XP3 5 and newer models 

# flash_f eature BOOT_MONITOR_ETHERNET # XP3 5 only 

# f lash_feature BOOT_MONITOR_TOKEN_RING # XP200 & XP400 
flash_f eature NTP 

# f lash_feature CLOCK 
flash feature SSADVT 
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Flashing the Local Browser into Memory 

To support the amount of memory required by the browser binaries, a 16MB 
flash memory option is available (for the NC200, NC400, and NC900 series 
only) that allows the Navio or Netscape browser to be stored in a network 
computer's flash memory. There are also three xp.cnf commands to support 
flashing the browser. 

To flash the Navio (Navigator 3.0) or Netscape executable files into a network 
computer's 12MB or 16MB flash memory, uncomment the do_f lash 
command in your xp.cnf 'file along with one of these commands: 

flash_feature NAVIO 
flash_feature NETSCAPE_LITE 
flash_feature NETSCAPE 

Upon booting, the xp. en/ commands specified above flash the browser 
executable files, listed in Table 2-10, Flash Features, into the network 
computer's 12MB or 16MB flash memory. 

• For the files that make up the NAVIO flash group, the total approximate size 
of these binaries is about 11MB uncompressed or about 5MB compressed. 

• For the files that make up the NETSCAPE_LITE flash group, the file size is 
about 19MB uncompressed or about 9MB compressed. 

• For the files that make up the NETSCAPE flash group, the file size is about 
26MB uncompressed or about 13MB compressed. 

Note: The full Netscape browser and operating system does not fit in 
the older 12MB flash option along with the NC operating system. 
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The other xp.cnf command allows the user to flash kiosk mode configuration 
files (normally found in the boot/navio directory for Navio or boot/.netscape 
directory for Netscape) into the flash ROM option: 

flash_feature NAVIO_CONFIG_FILES 
flash_feature NETSCAPE_CONFIG_FILES 

(The last command applies to both Netscape and Netscape_Lite.) 

Typically, you would flash the files listed in Table 2-10 only when there is no 
available host computer to boot from and you want the browser to operate 
solely from flash memory. The total approximate size of the Navio 
configuration files is 400K, 160K compressed. The size of the Netscape 
configuration files is 458K uncompressed, 84K compressed. 

Make sure the configuration files contain the appropriate settings before 
flashing because, once flashed, the configuration cannot be changed without re- 
flashing. Furthermore, when the network computer is configured for a language 
other than usascii, the appropriate change to the app-defaults path is also 
made, so it is important to set the language before flashing. 

Setting Browser File Access 

In kiosk mode for Navio, the browser's default configuration location is a navio 
directory under the boot directory on the boot host using the boot file access 
method. For Netscape, the default location is a .netscape directory. If you want 
to set the location to something other than the boot directory or change the host 
or file path, the default kiosk mode file access parameters can be overridden 
with three commands in the xp.cnf Tilt: 

parameter browser_def ault_f ile_access <access_method> 

parameter browser_def ault_f ile_host <hostname> 

parameter browser_def ault_f ile_path / <file_path> 

The first of these commands sets the file access method to be used to read 
browser configuration files when in kiosk mode. Valid values for 
<access_method> are NFS, ROM, DAP, TFTP, and NONE. When the access 
method is set to none, the browser uses the default boot access method which 
is set by the BMETHOD command. 
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The second command sets the name or IP address of the host that will provide 
configuration files when the browser runs in kiosk mode. If a name is used, it 
should be one that can be resolved using DNS (Domain Name Service) or 
which appears in the network computer' s Internet Host table. The generic name 
xp_boothost can be used in cases where the specific name of the boot host is not 
known. If NFS or ROM file access is used, the host name does not have to be 
set, but an NFS mount must be set up in the NFS table, and a hostname is 
required there. 

The third command sets the path to a directory in which the browser expects to 
find either a navio or .netscape subdirectory. This directory is expected to 
contain the browser configuration files that are typically found in a user's home 
navio directory or the boot/navio directory for Navio or the .netscape or 
boot/.netscape directories for Netscape (or Netscape_Lite) supplied on the 
install media. 



Browser Kiosk Examples 



This example shows how to make some changes to your xp.cnf file and reboot 
the network computer to flash the features into your 1 6MB flash memory board. 
It also shows how to make a few changes in the Boot Monitor and reboot again 
to get the browser to launch automatically and run in standalone kiosk mode. 

Note: Skip step 1 if flashing Netscape or Netscape _Lite. Netscape 

preferences are made via the preferences menu and stored in the 

preferences . jsfile. 

1 . On the host where the navio directory is found (tekxp/boot by default), edit 
the preferences file: 

a. Set the value of PROXY_URL to the local proxy server. For example: 

http : //proxy . ncd. com 

b. Set other values to configure Navigator, such as the home page, links, etc. 

2. Use the xp.cnf code in Example 2-6, Excerpted xp.cnf File for Netscape 
Browser Kiosk Operation using 16MB Flash Card, on page 2-159 to 
configure your network computers for kiosk mode. 

3. Edit your xp.cnf file, and uncomment the do_flash, flash_feature 
NETSCAPE, and flash_feature NETSCAPE_CONFIG_FILES commands 
by removing the # character at the beginning of the command. 
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4. Reboot your network computer to initiate the flash process. 
(See Examples 2-1, 2-2, or 2-3 beginning on page 2-157.) 

5. After flashing, edit your xp.cnf file and comment the do_flash, flash_feature 
NAVIO, and flash_feature NAVIO_CONFIG_FILES commands by placing 
a # in front of each command). 

6. Reboot the network computer and press any key before the progress bar 
reaches 100% to interrupt the boot process and enter the Boot Monitor. In the 
Boot Monitor, perform these steps: 

a. Reset the network computer with an NVF actorv. 

b. Set IAddr to the network computer's IP address. 

c. Set IHost to Local Router or something else so it does not try BOOTP or 
DHCP. 

d. Set IMask. 

e. Set IGate to Local Router IP address. 

f. Set BMethod to ROM. 

g. NVSave. 
h. Boot. 

7. When you reboot the network computer — this time from ROM — the Navio 
NC Navigator browser starts in kiosk mode. 

See the next two examples for typical kiosk applications. 
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Example 2-4. Excerpted xp.cnf File for Navio Browser Kiosk Operation 



enable_name_service 
preload LAUNCHER 
preload NETSCAPE_LITE 
preload MWM 
preload SETUP 
preload AUDIO_SERVER 
preload NAVIO 
preload NETSCAPE 
console_pages 



Sample xp.cnf f ile***********************## 
YES 

PERM 

NO 

NO 

NO 

PERM 

YES 

NO 

15 



start NAVIO 
start NTP 



YES 
YES 



# [YES I NO] 



parameter time_gmt_of f set -25200 
parameter time_dst_mode FOLLOW 
parameter time_dst_of f set 3600 



# Example: How to 
do_f lash 
f lash_f eature 
f lash_feature 
flash_f eature 
flash_f eature 
flash_f eature 
flash_f eature 
f lash_f eature 
flash_f eature 
flash_f eature 
f lash_f eature 
flash feature 



flash Navio into 12MB or 16MB flash card 

NAVIO #since full Netscape won't fit into 12MB flash 

NAVIO_CONFIG_FILES 

SYSTEM 

XPWM 

TEKSETUP 

TELNET 

REMOTE_CNF 

LAUNCHER 

AUDIO_SERVER 

FONTS # as specified in fonts. tbl 

NTP 



#need to include 75dpi font in fonts. tbl 
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Example 2-5. Excerpted xp.cnf File for Netscape Lite Browser Kiosk Operation using 12MB 
Flash Card 

4+4+*********************** Sample xp.cnf file *******************++++ 

enable_name_service YES 

preload LAUNCHER PERM 

preload NETSCAPE_LITE PERM -args "-geometry 860x900+80+60" 

preload MWM NO 

preload SETUP NO 

preload AUDIO_SERVER PERM 

preload NAVIO NO 

preload NETSCAPE NO 

console_pages 15 



Start NETSCAPE_LITE 
start NTP 



YES 
YES 



# [YES I NO] 



parameter time_gmt_of f set -25200 
parameter time_dst_mode FOLLOW 
parameter time_dst_of f set 3600 



# Example: How to 
do_f lash 
f lash_f eature 
f lash_feature 
flash_f eature 
flash_f eature 
f lash_f eature 
f lash_f eature 
f lash_f eature 
f lash_f eature 
f lash_f eature 
f lash_f eature 
flash feature 



flash Netscape Lite into 12MB or 16MB flash card 

NETSCAPE_LITE #this flashes Netscape_Lite 

NETSCAPE_CONFIG_FILES 

SYSTEM 

XPWM 

TEKSETUP 

TELNET 

REMOTE_CNF 

LAUNCHER 

AUDIO_SERVER 

FONTS # as specified in fonts. tbl 

NTP 



#need to include 75dpi font in fonts. tbl 
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Example 2-6. Excerpted xp.cnf File for Netscape Browser Kiosk Operation using 16MB Flash 
Card 



4+4+*********************** Sample xp.cnf file *******************++++ 



enable_name_service 
preload LAUNCHER 
preload NETSCAPE_LITE 
preload MWM 
preload SETUP 
preload AUDIO_SERVER 
preload NAVIO 
preload NETSCAPE PERM 
console_pages 



-args 



YES 
PERM 
NO 
NO 
NO 
PERM 
NO 
-geometry 860x900+80+60" 
15 



start NETSCAPE 
start NTP 



YES 
YES 



# [YES I NO] 



parameter time_gmt_of f set -25200 
parameter time_dst_mode FOLLOW 
parameter time_dst_of f set 3600 



# Example: How to 
do_f lash 
f lash_f eature 
f lash_feature 
flash_f eature 
flash_f eature 
f lash_f eature 
f lash_f eature 
f lash_f eature 
flash_f eature 
f lash_f eature 
f lash_f eature 
flash feature 



flash Netscape into 16MB flash card 
NETSCAPE #this flashes Netscape 

NETSCAPE_CONFIG_FILES 

SYSTEM 

XPWM 

TEKSETUP 

TELNET 

REMOTE_CNF 

LAUNCHER 

AUDIO_SERVER 

FONTS # as specified in fonts. tbl 

NTP 



#need to include 75dpi font in fonts. tbl 
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flash_file 

flash_file filename 

This command specifies a file to be added to flash ROM when using the flash 
memory feature. This is useful when you want to add files that are not already 
included as part of a flash feature. 

Parameters 

filename name of file to be flashed into flash ROM. 
In this example, the file myfile is flashed into flash ROM: 

flash_file myfile 

update_bootrom 

update_bootrom YES or NO and V.n.n 

Automatically updates the Boot Monitor to reflect the current version number 
without having to use the do_f lash command. 

Parameters 

YES automatically updates the Boot Monitor if the version number in 

the boot directory is greater than the current Boot Monitor. 

NO does not automatically update the Boot Monitor. You can still 

update it by using dojlash with the flash Jeature 
BOOT_MONITOR. The update_bootrom command only 
affects the automatic updating of the Boot Monitor. 

V.n.n indicates the version number you want to flash, up to three digits; 

for example, version 8.4.1. You can specify an exact version 
number, even an older one. If you specify the version currently 
running on your network computer, the Boot Monitor is not 
reflashed. 

In this example, the Boot Monitor updates automatically whenever the network 
computer boots: 

update_bootrom YES 
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Flash Memory Status Messages 

The following messages may appear in the specified Console window when 
using the Flash Memory feature. If the Console window is not opened in the 
same session at which the Flash was done, any Flash Memory status messages 
appear the next time the Console is opened. 

FLASH: <ip_address> Flash Option Update Complete, n bytes flashed, 
n percent capacity 

The Flash update was successful. 
ERROR: Not enough available memory 

If there is not enough available memory, the flash process stops. Files that 
have already been flashed, however, remain in ROM. As a rule, do not run 
any other clients while booting using the Flash Memory feature. 

ERROR: Flash hardware not installed 

The network computer must have the Flash Memory hardware installed. 
ERROR: NC is booted from ROM - reboot from the network 

The network computer was booted from ROM when starting the Flash. The 
network computer must be booted from the network to perform a Flash. 

ERROR: No files specified in xp.cnf 

The do_f lash command was enabled, but no features were specified. Be 
sure to specify those features you want to include using the flash Jeature 
command. 

ERROR: Could not find any files to flash 

The do_f lash and f lash_f eature commands were enabled but no files 
were found. 

NON-FATAL WARNING: Could not open all requested files 

A file could not be opened. Check the specified boot directory. 
NON-FATAL WARNING: Not enough room to flash all requested files 

More files were Flashed than available memory could hold. To estimate the 
amount of ROM needed, add the size of the files to be flashed and multiply 
by .40 (40%). 

NON-FATAL WARNING: Could not find fonts.tbl 
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Fonts were not flashed. Check the primary and/or secondary paths for the 
fonts. tbl file. 

NON-FATAL WARNING: Could not find fonts.dir 

Fonts were not flashed. The fonts.dir file was not found in the specified font 
directory. 

ERROR: Flash hardware has failed - contact your local NCD service 
representative 

Hardware problems prevented a successful flash. The error displays a series 
of X's. Report the following error codes as follows: 
AABBCCDD EEEEEEEE FFGGHHII 

AA - Flash manufacturer's identification 

BB - Flash part's identification number 

CC - Flash part number 

DD - Error type 

03 - Low memory error 

05 - Flash chip corrupted 

06 - Unsupported manufacturer ID or flash ID 

13 - Flash erase failed 

14 - Flash verify failed 

15 - Flash program failed 

16 - Flash checksum failed 

EEEEEEEE - Address 
FF - Expected result 

GG - Actual result 

FFGG - Expected checksum 

HHII - Actual checksum 
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HostMenu Configuration 



HostMenu is a client that displays lists of available login hosts. A network 
computer user uses the mouse to select the host for logging in to a system. The 
different lists are accessed by clicking a button on the HostMenu. The buttons 
are: 

• xdmcp displays hosts that responded to the network computer ' s xdm 

broadcast. If the responding hosts have a corresponding 
xdmcp _menu_entry in the xp.cnf file, they are listed 
alphabetically at the top of the XDMCP list, followed by 
hosts without an xdmcp _menu_entry. 

• VMS TDEnet displays hosts specified in thexp.cn/file with the 

vms_menu_entry command and the TDEnet parameter 
specified. 

• VMS TCP/IP displays hosts specified in the xp.cn/file with the 

vms_menu_entry command and the TCPIP parameter 
specified. 

• TELNET displays hosts specified in the xp.cnf file with the 

telnet_menu_entry command. 

• CTERM displays hosts specified in the xp.cnf file with the 

cterm_menu_entry command. 

• IBM displays hosts specified in the xp.cnf file, with the 

ibm_menu_entry command. 

• LAT displays available LAT services that are broadcast from hosts 

running LAT. LAT services cannot be added through the 
xp.cnf file, but they can be reserved using the 
lat_service_entries and the lat_services_table 
commands explained earlier in this chapter. 

• WinDD displays Windows NT application servers specified xp.cnf 

file with the windd_menu_entry command. 
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xdmcp_menu_entry 

xdmcp_menu_entry hostname or ip_address 

Determines the order that hosts responding to the network computer's xdm 
broadcast are displayed in the HostMenu XDMCP list. If a responding host has 
a corresponding xdmcp_menu_entry, it is listed before hosts without an 
xdmcp_menu_entry. Hosts can be specified by name or address. 

Parameters 

hostname specifies the name of the host to be displayed. 

ip_address specifies the IP address of the host to be displayed. 

In this example, the host nevada is listed first in the HostMenu and oregon 
second: 

xdmcp_menu_entry nevada 
xdracp_menu_ent ry Oregon 

thm_broadcast 

thm_broadcast ENABLED or DISABLED 

Specifies whether the HostMenu client automatically broadcasts to the local 
subnet for XDM hosts. 

For example, if you enter 145.67.44.98 in the xdmcp_menu_entry command 
and enable the thm_broadcast command, the host whose address is 
145.67.44.98 displays in the HostMenu client, as well as all other available 
hosts on subnet 44. If you disable the thm_broadcast command, only the host 
whose address is 145.67.44.98 displays in the HostMenu client. 

Parameters 

ENABLED specifies that the Host Menu client broadcasts to local subnets for 
XDM hosts. 

DISABLED specifies that the Host Menu client does not broadcast to local 
subnets. 

In this example, the Host Menu client broadcasts to the local subnets: 

thm broadcast ENABLED 
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thm_entrybox 

thm_entrybox ENABLED or DISABLED 

Specifies whether the Host Name field displays at the bottom of the HostMenu 
window. The Host Name field enables users to connect to a host that is not listed 
in the HostMenu client. 

Parameters 

ENABLED specifies that the Host Name field appears at the bottom of the 

HostMenu client. This enables users to enter the name of a host to 
connect to if that host does not appear in the Host Name list 
(default). 

DISABLED specifies that the Host Name field does not appear at the bottom of 
the HostMenu client. This prevents users from using hosts that are 
not displayed in the Host Name list. 

In this example, the Host Name field does not appear in the HostMenu. 

thm_entrybox DISABLED 

vms_menu_entry 

vms_menu_entry TCPIP or TDEnet or hostname or ip_address and PREF or 
NOTPREF 

Specifies the VMS hosts to be displayed with the HostMenu VMS TDEnet or 
VMS TCP/IP lists. Hosts can be specified by name or address. 

Parameters 

TCPIP specifies TCP/IP as the connection protocol. 

TDEnet specifies TDEnet as the connection protocol. 
hostname specifies the name of the host to be displayed. 
ip_address specifies the internet protocol address of the host to be displayed. 
PREF specifies a preferred host. Preferred hosts are listed first. 

NOTPREF specifies a non-preferred host. 
In this example, Idaho is preferred, and Utah is not preferred: 
vms_menu_entry idaho PREF 
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vms_menu_entry Utah NOTPREF 



tel net_men u_entry 



tt\ntt_mtnu_tntryhostname or address and PREF or NOTPREF and 
TEK220 or TEK340 

Specifies the Telnet hosts to be displayed with the HostMenu TELNET list. 
Hosts can be specified by name or address. In addition to specifying hosts, you 
can also specify which emulator starts when a user selects a host. 

Parameters 

Note: The hostname or address parameter is required. The remaining 
parameters are optional. 

hostname specifies the name of the host to be displayed. 

address specifies the Internet protocol address of the host to be displayed. 

PREF specifies a preferred host. Preferred hosts are listed first. 

NOTPREF specifies a non-preferred host. This is the default. 

TEK220 specifies that a TEK220 emulator session starts when a user 
selects the specified host. This is the default. 

TEK340 specifies that a TEK340 emulator session starts when you select 
the specified host. If the TEK340 option is authorized, the 
TEK340 emulator starts by default instead of the TEK220 
emulator. 

In this example, oregon is preferred, and nevada is not preferred: 

telnet_menu_entry Oregon PREF 
telnet_menu_entry nevada NOTPREF 

In this example, sierra is a preferred host, and a TEK340 emulator session starts 
when a user selects sierra: 

telnet_menu_entry sierra PREF TEK340 
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cter m_men u_entry 



cttrm_mtnu_tntr:yhostname or address and PREF or NOTPREF and 
TEK220 or TEK340 

Specifies the CTERM hosts to be displayed with the HostMenu CTERM list. 
Hosts can be specified by name or address. In addition to specifying hosts, you 
can also specify which emulator starts when a user selects a host. 

Parameters 

Note: The hostname or address parameter is required. The remaining 
parameters are optional. 

hostname specifies the name of the host to be displayed. 

address specifies the TDEnet address of the host to be displayed. 

PREF specifies a preferred host. Preferred hosts are listed first. 

NOTPREF specifies a non-preferred host. This is the default. 

TEK220 specifies that a TEK220 emulator session starts when a user 
selects the specified host. This is the default. 

TEK340 specifies that a TEK340 emulator session starts when a user 

selects the specified host. If the TEK340 option is authorized, the 
TEK340 emulator starts by default instead of the TEK220 
emulator. 

In this example, the host Idaho is a preferred host, and Utah is not preferred: 

cterm_menu_entry idaho PREF 
cterm_menu_entry Utah NOTPREF 

In this example, vista is a preferred host, and a TEK340 emulator session starts 
when a user selects vista: 

cterm_menu_entry 12.44 PREF TEK340 
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ibm_menu_entry 



\bva_rcitrm_tntvyhostname or ip_address PREF or NOTPREF and 
TEK3270 and 2 or 3 or 4 or 5 and TN or OCS 

Specifies the IBM hosts to be displayed with the HostMenu IBM list. Hosts can 
be specified by name or address. In addition to specifying hosts, you can also 
specify which emulator starts when a user selects a host. 

Parameters 

Note: The hostname or address parameter is required. The remaining 
parameters are optional. 

hostname specifies the name of the host to be displayed. 

address specifies the Internet protocol address of the host to be displayed. 

PREF specifies a preferred host. Preferred hosts are listed first. 

NOTPREF specifies a non-preferred host. This is the default. 

TEK3270 specifies that a TEK3270 emulator session starts. If the TEK3270 
option is authorized, the TEK3270 emulator starts by default. 

2, 3, 4, 5 specifies the emulator model number. The default is 2. 

TN specifies that the emulator uses the Telnet protocol. 

OCS specifies a connection to an OpenConnect Service. Two 

conditions apply: you must have an OpenConnect Server, and 
your network computer must have an assigned name. 

In this example, sapphire is a preferred host, and a TEK3270 emulator starts 
when a user selects sapphire: 

ibm_menu_entry sapphire PREF TEK3270 2 TN 
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lat_menu_emulator 

lat_menu_emulator TEK220 or TEK340 

Specifies that a TEK220 or TEK340 emulator session starts when a user 
connects to a LAT service from the HostMenu LAT list. 

Parameters 

TEK220 specifies that a TEK220 emulator session starts. 
TEK340 specifies that a TEK340 emulator session starts. 

In this example, a TEK220 session starts when the user connects to a LAT 
service listed in the HostMenu: 

lat_menu_emulator TEK220 

windd_menu_entry 

windd_menu_entry application server name or address and PREF or 
NOTPREF and 640 or 800 or 1024 or 1280 and NORECONNECT or 
RECONNECT and MENUBAR or NOMENUBAR and EXIT or NOEXIT 

Specifies the Windows NT hosts to be displayed with the HostMenu WINDD 
list. Hosts can be specified by name or address. 

Parameters 

Note: The application server name or address parameter is required. 
The remaining parameters are optional. 

name specifies the name of the application server to be displayed. 

address specifies the Internet protocol address of the host to be displayed. 

PREF specifies a preferred host. Preferred hosts are listed first. 

NOTPREF specifies a non-preferred host. This is the default. 

600 specifies geometry sizes of the WinDD ICA window to be 

600 x 480. 

800 specifies geometry sizes of the WinDD ICA window to be 800 x 600. 

1024 specifies geometry sizes of the WinDD ICA window to be 1024 x 768. 

1280 specifies geometry sizes of the WinDD ICA window to be 

1280 x 1024. 
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NORECONNECTspecifies not to reconnect to an application server after 
logging off. This is the default. 



RECONNECT 

MENUBAR 
NOMENUBAR 
EXIT 
NOEXIT 



specifies to reconnect to an application server after logging 
off. 

displays a menubar. This is the default. 

turns off the menubar. 

exits WinDD session on server logout. 

does not exit WinDD session on server logout. 



In this example, oregon is preferred, and nevada is not preferred: 

windd_menu_entry "oregon" "PREF" 
windd_menu_entry "nevada" "NOTPREF" 

In this example, sierra is a preferred host, displaying 1280 resolution, no 
reconnect, and no menubar: 

windd_menu_entry " sierra" "PREF" " 128 " "noreconnect " 
"nomenubar " 
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Local Print Spooler/Printing 

The following commands are used for printing. For more information about 
using these commands and printing, refer to Appendix A, Printing. 

Command Page 

enable_print_spooler 2-171 

spooler_size 2-172 

spooler_listen_port 2-172 

spooler_local_queue 2-173 

spooler_remote_queue 2-173 

spooler_auth_host 2-174 

spooler_auth_user 2-174 

disable_lpd_authhost 2-175 

enable_print_spooler 

enable_print_spooler YES or NO 

Specifies whether or not the print spooler is enabled. The spooler runs locally 
on the network computer and enables you to perform "text only" printing. 
When enabled, the lpd process is downloaded from the host. The spooler 
processes printing requests from the network computer or from a remote host. 
The printing requests can be sent to a printer connected to the network 
computer, or forwarded to a remote printer on the network. 

Parameters 

YES specifies that the print spooler is enabled. 

NO specifies that the print spooler is not enabled. 

In this example, the print spooler is enabled. 

enable_print_spooler YES 
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spooler_size 

spooler_size integer 

Specifies an amount of memory (in bytes) to reserve for the print spooler's use. 
By default, 4096 bytes are reserved and is enough for printing screens. To print 
files larger than 4096 bytes, increase the amount of reserved memory 
accordingly. The reserved memory is not be available to the X server or local 
clients, so allocate memory only as needed. 

Parameter 

integer specifies the amount of memory (in bytes) to reserve for the print 

spooler (default is 4096). 

In this example, 8000 bytes of memory is reserved for the print spooler: 

spooler_size 8000 

spooler_listen_port 

spooler_listen_port <portnumber> 

Specifies the TCP port number on which the print spooler listens for print 
requests. The default is port 515, which is reserved for printer protocol by 
Internet convention and is compatible with most systems. Therefore, this 
number should not have to be changed. 

Parameter 

<portnumber> specifies the TCP port number which listens for printer requests 
from the print spooler. 

In the following example, port 515 listens for printer requests from the print 
spooler. 

spooler_listen_port 515 
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spoolerJocaLqueue 

spooler_local_queue queue_name and SPO or SP1 or PPO 

Defines a printer queue name for a specified port and reserves the port for 
printing. A local queue can accept print requests from a remote host, or from 
the screen print feature even when the print spooler is not enabled. 

Parameters 

queue _name specifies the name of the local queue (up to 3 1 characters in 
length). 

SPO specifies Serial port 0. 

SP1 specifies Serial Port 1. 

PPO specifies the Parallel port. 

In this example, the lp queue is used for a printer connected to the parallel port: 

spooler_local_queue lp PPO 

spooler_remote_queue 

spooler_remote_queue queue_name and host_name and remote _queue_name 

Defines a local queue that forwards print requests to a remote printer to be 
printed via a remote queue on that remote host. A remote queue can be used by 
the screen print feature even when the print spooler is not enabled. 

Parameters 

queue_name specifies the local queue name (up to 3 1 characters in length) that 
forwards print requests to a remote host. 

host_name specifies the name of the remote host. The specified host must be 
listed in the Internet Host Table (located in Setup) or with domain 
name service. 

remote _queue_name 

specifies the name of the lpd print queue on the remote host (up 
to 31 characters in length). 

In this example, lp is the local queue that forwards print requests to the queue 
named printer on remote host sierra: 

spooler_remote_queue lp sierra printer 
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spooler_auth_host 

spooler_auth_host host_name 

Specifies the hosts that are allowed print queue access. By default, the print 
spooler accepts print requests from all hosts listed in the Internet Host Table 
(located in Setup) or with domain name service. This command allows you to 
limit the hosts that can access the print queue. To include more than one host, 
copy this command for each host. 

Parameter 

host_name specifies the host name to be allowed print queue access. The host 
must be specified with the ip_host_entry, the ip_host_table, be 
listed in the network computer's host.tbl file, or be resolved with 
domain name service. 

In this example, hosts montana and Oregon are allowed print queue access: 

spooler_auth_host montana 
spooler_auth_host Oregon 

spooler_auth_user 

spooler_auth_user user_name 

Specifies the users that are allowed print queue access. By default, the print 
spooler accepts print requests from all users. This command allows you to limit 
the users that can access the print queue. To include multiple users, copy this 
command for each user. 

Parameter 

userjiame specifies the name of the user to be allowed print queue access. 
In this example, users mikeb, Steves, and paigek are allowed print queue access: 

spooler_auth_user mikeb 
spooler_auth_user steves 
spooler_auth_user paigek 



2-1 74 NCBridge Reference Manual 



disable _lpd_authhost 



disable_lpd_authhost 

disable_lpd_authhost YES or NO 

This command disables the spooler_auth_host and 
spooler_auth_user commands to allow printing from any host and any user. 

Parameter 

YES Disable the spooler_auth_host and spooler_auth_user 

commands and allow printing from any host and user. 

NO Enable spooler_auth_host and spooler_auth_user 

commands. This is the default. 

In this example, printing is allowed from any host and user: 

disable_lpd_authhost YES 
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DEC Session Manager Configuration 

dec_sme_resetserver 

dec_sme_resetserver RESET or IGNORE 

Specifies whether the server is reset when the DEC Session Manager quits. By 
default, when the DEC Session Manager quits, the server is reset. But when you 
have multiple Session Managers running, closing one Session Manager resets 
the server and closes all others. Set this to IGNORE if you use multiple Session 
Managers simultaneously. 

Parameters 

RESET specifies that the server is reset when a DEC Session Manager 

quits. 

IGNORE specifies that the server is not reset when a DEC Session Manager 
quits. 

In this example, the server resets when the DEC Session Manager quits: 

dec sme resetserver RESET 
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TFTP Daemon 

enable_tftp_daemon 

enable_tftp_daemon YES or NO 

Specifies whether the tftp daemon is enabled on an NCD network computer. 
This command is used to enable a master network computer to boot other NCD 
network computers. The master network computer must be equipped with Flash 
memory, and you must flash the appropriate boot files. 

To boot other network computers from the enabled master network computer, 
use TFTP as the boot_method, specify the master's name or address for the 
bootjiost, and use /rom/os.<model> (where <model> is the network computer 
model) for the boot_path. 

Parameters 

YES specifies that the tftp daemon is enabled on the network 

computer. 

NO specifies that the tftp daemon is not enabled on the network 

computer. 

In this example, the tftp daemon is enabled for the network computer named 
xmaster: 

select TERMINAL NAME=xmaster enable_tf tp_daemon YES 
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Exiting Telnet 

telnet_exit_on_logout 

telnet_exit_on_logout YES or NO 

Specifies whether Telnet quits when you log out from a host in a Telnet local 
client. 

Parameters 

YES specifies that Telnet quits when you log out of a local Telnet 

session. 

NO specifies that Telnet does not quit when you log out of a local 

Telnet session. This is the default. 

In this example, Telnet quits when you log out of a Telnet session: 

telnet_exit_on_logout YES 

Exiting a Session 

session_exit_on_logout 

session_exit_on_logout YES or NO 

Specifies whether a Telnet, Cterm or LAT session exits when you log off of the 
host on which the session is running. 

Parameters 

YES specifies that when you log out from a host in a Telnet, Cterm, or 

LAT local client, the session exits automatically. 

NO specifies that when you log out from a host in a Telnet, Cterm, or 

LAT local client, the session does not exit. 



2-1 78 NCBridge Reference Manual 



Analog Video Configuration 

Analog Video Configuration 

Available on XP300V and X31 7CVJ series only. 

Use these commands to configure the Audio Video Player: 

Command Page 

video_source_label 2-179 

video_source 2-180 

video_attribute_group 2-181 

video_visual_preference 2-182 

video_encoding 2-183 

video_volume 2-184 

video_switch 2-185 

video_field_duplicate 2-186 

video_window_size 2-187 

video_position 2-188 

video_window_position 2-189 

video_source_label 

video_source_label label and source 

There are three predefined video sources: SVIDEO_l, COMPOSITE_l, and 
COMPOSITE_2. You can use these video source names, or create your own 
source name using this command. (To use the predefined video source names, 
go on to the next command, video_source.) 

Parameters 

label specifies the source label, or name. 

source specifies which video source to associate with the source name: 

SVIDEO_l, COMPOSITE_l, or COMPOSITE_2. 

In this example, the name adam is the video source label for SVIDEO_l: 

video source label adam SVIDEO 1 
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video_source 

video_source source and ON or OFF 

Specifies the video source. 

Parameters 

source Specifies the video source to use: SVIDEO_l, COMPOSITE_l, 

COMPOSITE_2. (To define your own video source name, use the 
video_source_label command described above.) 

ON specifies that the video window opens and the video displays 

when the Analog Video Player starts. 

OFF specifies that the video window is not automatically opened when 

the Analog Video Player starts. 

In this example, the video source is COMPOSITE_l and the video window 
automatically opens when the Analog Video Player starts: 

video_source COMPOS I TE_1 ON 

In this example, the video source labelled adam automatically opens when the 
Analog Video Player starts: 

video source adam ON 
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video_attribute_group 

video_attribute_group source and group_name 

Specifies that a particular group of attributes is associated with a video source. 
To create a group of video attributes, assign a name to a string value on any of 
the video configuration commands. Then add the configuration settings you 
want to that group. You can create as many attribute groups as you like. 

Parameters 

source specifies the video source to which the attribute group is applied. 

Enter one of the three predefined sources 
(SVIDEO_l, COMPOSITE_l, COMPOSITE_2) or a source 
label created with the video_source_label command. 

group_name specifies the name of the attribute group (up to 8 characters). 

In this example, the attribute group Oregon is assigned to video source 
COMPOSITE_2: 

video_attribute_group Oregon 

Oregon can be used in other analog video configuration commands as the string 
value to add video settings to the attribute group: 

video_visual_pref erence Oregon TINT 200 
video_encoding Oregon NTSC 
video_volume Oregon 200 
video_switch Oregon COLOR ON 

The commands listed above are explained on the following pages. 
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video_visual_preference 



video_attribute string and BRIGHTNESS and CONTRAST and TINT and 
COLOR and value 

Video attributes can be set for a single video source, or can be created in a group 
of multiple attributes and then assigned to video sources. 

Parameters 

string specifies one of the following: a video source label (defined 

with the video_source_label command); a predefined 
video source (SVIDEO_l, COMPOSITE_l, 
COMPOSITE_2); or a label up to eight characters that 
contains video attributes that are used in other video 
configuration commands and assigned to a video source 
(using the video_attribute_group command). 

BRIGHTNESS specifies the brightness settings for the information being 
played in the video window. 

CONTRAST specifies the contrast settings for the information being 
played in the video window. 

TINT specifies the tint settings for the information being played in 

the video window. 

COLOR specifies the color settings for the information being played 

in the video window. 

value specifies the intensity value of the attributes (a number from 

-1000 to 1000). The default is zero. 

In this example, the tint for video source SVIDEO_l is set to 100, which is 
brighter than the default, and the brightness is set to 200: 

video_visual_preference SVIDEO_l TINT 100 
video_visual_preference SVIDEO_l BRIGHTNESS 200 

In this example, the brightness for video source adam is set to -100, which is 
less bright as the default: 

video_visual_preference adam BRIGHTNESS -100 
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In this example, the video preferences are added to the attribute group Oregon: 

video_visual_preference Oregon BRIGHTNESS 200 
video_visual_pref erence Oregon TINT 200 
video_visual_pref erence Oregon COLOR 100 

video encoding 

video_encoding string and NTSC or PAL 

Specifies how the video signal is encoded on the cable. 

Parameters 

string specifies one of the following: a video source label (defined with 

the video_source_label command); a predefined video 
source (SVIDEO_l, COMPOSITE_l, COMPOSITE_2); or a 
label up to eight characters that contains video attributes that are 
used in other video configuration commands and assigned to a 
video source (using the video_attribute_group command). 

NTSC specifies National Television System Committee encoding. 

PAL specifies Phase Alternation Line-rate encoding. 

In this example, the video encoding for video source SVIDEO_l is set to 
NTSC: 

video_encoding SVIDEO_l NTSC 
In this example, the video encoding for video source adam is set to PAL: 

video_encoding adam PAL 

In this example, the video encoding NTSC is added to the label oregon which 
contains video player settings that can be referred to in other video 
configuration commands: 

video_encoding Oregon NTSC 
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video_volume 

video_volume string and value 

Specifies the volume level for information played in the Analog Video player. 

Parameters 

string specifies one of the following: a video source label (defined with 

the video_source_label command); a predefined video 
source (SVIDEO_l, COMPOSITE_l, COMPOSITE_2); or a 
label up to eight characters that contains video attributes that are 
used in other video configuration commands and assigned to a 
video source (using the video_attribute_group command). 

value specify the volume level value between to 100. is minimum, 

100 is maximum. 

In this example, the volume level for video source SVIDEO_l is set to 100: 

video_volume SVIDEO_l 10 

In this example, the volume level 100 is added to the label oregon which 
contains video player settings that can be referred to in other video 
configuration commands: 

video_volume Oregon 100 
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video switch 



video_switch string and COLOR or AGC or ASPECT_RATIO or SOUND 
or OVERSCAN or ON or OFF 

Specifies the video appearance settings. 

Parameters 



string 



COLOR 



AGC 



specifies one of the following: a video source label (defined with 
the video_source_label command); a predefined video 
source (SVIDEO_l, COMPOSITE_l, COMPOSITE_2); or a 
label up to eight characters that contains video attributes that are 
used in other video configuration commands and assigned to a 
video source (using the video_attribute_group command). 

specifies whether the image in the video window plays in color or 
in black and white. Specify ON for color, or OFF for black and 
white. 

specifies the Automatic Gain Control setting. 



ASPECT_RATIO 

specifies the window sizing attributes. If ON, the appropriate 
aspect of the image is maintained when you resize the video 
window. If OFF, you can resize the window to any size and the 
aspect ratio will not be maintained. When OFF, the image in the 
window may distort. 

SOUND specifies whether or not the video sound is audible. Specify NO 
to mute the sound, or YES to hear the sound. 

OVERSCAN specifies whether the image in the video window is overscan 
mode. If ON, the full image displays. If off, the image is 
reduced by 10%. 



OFF 
ON 



specifies that a switch is turned off. 
specifies that a switch is turned on. 



In this example, the color and sound switches are turned on for video source 
SVIDEO_l: 

video_switch SVIDEO_l SOUND ON 
video switch SVIDEO 1 COLOR ON 
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video_field_duplicate 

video_field_duplicate string and ON or OFF or AUTO 

Specifies whether the Analog Video Player uses field duplication. Field 
duplication is used primarily to eliminate blurred images when viewing fast 
motion videos or information. 

Parameters 

string specifies one of the following: a video source label (defined with 

the video_source_label command); a predefined video 
source (SVIDEO_l, COMPOSITE_l, COMPOSITE_2); or a 
label up to eight characters that contains video attributes that are 
used in other video configuration commands and assigned to a 
video source (using the video_attribute_group command). 

ON specifies that field duplication is enabled. 

OFF specifies that field duplication is disabled. 

AUTO specifies that the player determines whether to use field 

duplication based on the video window size. 

In this example, the field duplication for SVIDEO_l is set to AUTO: 

video_f ield_duplicate SVIDEO_l AUTO 

In this example, field duplication is enabled and added to the label Oregon 
which contains video player settings that can be referred to in other video 
configuration commands: 

video_f ield_duplicate Oregon ON 
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video_window_size 

video_window_size string and width and height 

Specifies the size of the video window in which the video plays. 

Parameters 

string specifies one of the following: a video source label (defined with 

the video_source_label command); a predefined video 
source (SVIDEO_l, COMPOSITE_l, COMPOSITE_2); or a 
label up to eight characters that contains video attributes that are 
used in other video configuration commands and assigned to a 
video source (using the video_attribute_group command). 

width specify the window width in pixels. 

height specify the window height in pixels. 

In this example, the video window size for video source COMPOSITE_2 is 750 
pixels wide and 500 pixels high: 

video_window_size COMPOSITE_2 75 500 

In this example, the label template is created and contains video player settings 
which can then be used in other video configuration commands: 

video_window_size template 300 250 
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video_position 

video_position string and X and Y 

There are two video windows, one for user controls and one for the actual video 
display. This command specifies the position of the video display window on the 
screen. 

Parameters 

string specifies one of the following: a video source label (defined with 

the video_source_label command); a predefined video 
source (SVIDEO_l, COMPOSITE_l, COMPOSITE_2); or a 
label up to eight characters that contains video attributes that are 
used in other video configuration commands and assigned to a 
video source (using the video_attribute_group command). 

X specify the X position in pixels from the upper left corner of the 

display. 

Y specify the Y position in pixels from the upper left corner of the 

display. 

In this example, the video window is positioned 12 pixels by 14 pixels from the 
upper left corner of the display: 

video_window_position ADAM 12 14 

In this example, the window position 30 by 50 is added to the label template 
which can then be used in other video configuration commands: 

video_position template 30 50 
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video_window_position 

video_window_position string and X and Y 

There are two video windows, one for user controls and one for the actual video 
display. This command specifies the position of the user control window on the 
screen. 

Parameters 

string specifies one of the following: a video source label (defined with 

the video _source_label command); a predefined video source 
(SVIDEO_l, COMPOSITE_l , COMPOSITE_2); or a label up to 
eight characters that contains video attributes that are used in 
other video configuration commands and assigned to a video 
source (using the video _attribute_group command). 

X specify the X position in pixels from the upper left corner of the 

display. 

Y specify the Y position in pixels from the upper left corner of the 

display. 

In this example, the video window is positioned 12 pixels by 14 pixels from the 
upper left corner of the display: 

video_window_position ADAM 12 14 

In this example, the window position 30 by 50 is added to the label template 
which can then be used in other video configuration commands: 

video_window_position template 3 5 
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Digital Video Configuration 



This command has been added to the Remote Configuration file (xp.cnf) to 
enable and configure the Multicast feature: 

video_multicast_entry 

Note: Multicast is only available on NC200/NC400 series network 
computers. The MPEG option must be installed. 

video_multicast_entry 

video_multicast_entry addr and port and text 

This command creates a Multicast channel entry. These channels are available 
through the Multicast menu in the Digital Video Player. Each command creates 
a channel. To create multiple channels, copy this command for each channel 
(maximum of 10). 

Parameters 

addr specify the Multicast address. This address must be the same as 

the address being used by the Multicast server. 

port specify the Multicast port number. This port number must be the 

same as the port number being used by the Multicast server. 

text specify the text to be displayed in the Multicast menu. 

In this example, the Multicast address is 224. 100.50. 1 , the port number is 1001 , 
and the text is Blues Channel: 

video_multicast_entry "224.100.50.1" "1001" "Blues Channel" 
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The examples below set up the channels "Jazz Channel", "Rock Channel", and 
"News Channel" using the video_multicast_entry command in the xp.cnf file. 

video_multicast_entry "224.200.50.10" "3000" "Jazz Channel" 

video_multicast_entry "224.200.50.11" "3000" "Rock Channel" 

video_multicast_entry "224.200.50.11" "3001" "News Channel" 

Note: In the above example, the second two channels are broadcasted 
from the same server (224.200.50.11) so they need different ports 
(3000 and 3001). 

The next example starts a Multicast session and plays the second Multicast 
channel ("Rock Channel") in the Multicast channel array above set in the xp.cnf 
remote configuration file. 

xpsh -display twinkle : vplay -chan 2 



NCBridge Reference Manual 2-1 91 



53 



Chapter 2 Remote Configuration 



Console Configuration 

The Remote Console feature allows you to send network computer console 
messages across the network to a log file on a specified host. This allows you 
to view system messages from several network computers in a single file on a 
single host. 

To use this feature, you must specify in the /etc/ sy slog, conf file where the 
network computer console messages are to be placed. They can be placed in an 
existing file already specified in syslog.conf, or to a new file. For information 
about editing the syslog.conf file, refer to the syslog.conf or syslogd man pages 
on your host. 

These commands have been added to the Remote Configuration file (xp.cnf) to 
enable and configure the Remote Console feature: 

enable_remote_logging 

loghost 

logfacility 

logpriority 

enable_remote_logging 

enable_remote_logging YES or NO 

Specifies that the console messages are sent to a log file via syslogd on a 
specified host. 

Parameters 

YES specifies that network computer console messages are to be sent 

to a specified log file. 

NO specifies that the console messages are not to be sent to a log file. 

In this example, console messages are to be sent to a log file: 

enable_remote_logging YES 
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loghost 

loghost ip_address or host name 

Specify the IP address or name of the host on which you want console messages 
to be sent. 

Parameters 

ip_address specifies the host's IP address. 

host name specifies the host name. 

In this example, the console messages are sent to a file on the host whose 
address is 134.22.333.45: 

loghost 134.22.333.45 

logfacility 

logf acility facility 

Specify the type of message. Refer to the syslog.conf man page for a list of 
available facilities. The default is LOG_LOCAL0. 

In this example, the facility is set to LOG_LOCAL0: 

logfacility LOG_LOCAL0 

logpriority 

logpriority level 

Specifies the priority level of the console messages. Refer to the syslog.conf 
man page for a list of available levels. The default is LOG_INFO. 

In this example, the priority level for console message is LOG_INFO: 

logpriority LOG_INFO 
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console_pages 

console_pages integer 



Specifies the number of console screen pages that are retained in the Console 
buffer displayed on the NC Console. 

A scrollbar provided on the left side of the Console window enables the user to 
view various pages in the Console window by moving the slider up or down 
with the mouse cursor. 

Clicking the button in the upper left corner of the Console window clears only 
the current viewable text in the Console window. 

Parameters 

integer specifies the number of pages (between 1 and 64) to be held in the 

Console's buffer. The default is 4. 

In this example, 6 pages are retained in the Console's buffer: 

console_pages 6 
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WinDD ICA Client Configuration 



These commands are only used when the WinDD ICA client is invoked from the 
Client Launcher: 

Command Page 

default_windd_host 2-196 

windd_host_entry 2-196 

windd_auto_login 2-197 

windd_app_name 2-197 

windd_app_login 2-198 

windd_app_pass 2-198 

windd_app_domain 2-198 

windd_size 2-199 

windd_auto_connect 2-199 

windd_auto_reconnect 2-199 

windd_menubar 2-200 

windd_entrybox 2-200 

windd_auto_numlock 2-200 

windd_comm_port_mapping 2-201 

windd_colors 2-201 

windd_server_browser 2-202 

windd_server_sort 2-202 

windd_keysym_only 2-203 

windd_hot_toggle_keysym 2-203 

windd_exit_on_logout 2-203 

windd_ica_port 2-204 

windd_local_floppy 2-204 

windd_outbuf_delay 2-204 

windd_bandwidth 2-205 

windd_preload_colors 2-205 

windd_pixel_perfect_lines 2-205 

windd_compress 2-206 

windd_max_compress_disable . . .2-206 
ppp_auto_disconnect 2-206 
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default_windd_host 

default_windd_host ip_address or hostname 

The network computer uses this entry to connect to a specific Windows NT host 
when you invoke WinDD from the Client Launcher. If you specify the host by 
name, the host must be specified with ip_host_entry, or in ip_host_table. 

Parameters 

ip_address specifies the IP address of the host. 
hostname specifies the name of the host. 

In this example, the default WinDD host is oregon: 

def ault_windd_host "oregon" 

windd_host_entry 

windd_host_entry ip_address or hostname 

Adds the Windows NT server to the network computer's RAM. If you use the 
hostname, it must be previously specified with ip_host_entry, ip_host_table, be 
listed in the network computer's hosts. tbl file, or be resolved with Domain 
Name Service (DNS). 

Parameters 

ip_address specifies the IP address of the Windows NT host. 

hostname specifies the name of the Windows NT host (up to 10 characters). 

In this example, the Windows NT host mthood is added to RAM: 

windd_host_entry "mthood" 



2-1 96 NCBridge Reference Manual 



windd_auto_login 



windd_auto_login 

windd_auto_login YES or NO 

Specifies whether to automatically attempt to login to either the default 
Windows NT host (specified by the def ault_windd_host command) or 
the published application name (specified by the windd_app_name 
command). The windd_auto_login command uses the username, 
password, and domain provided by the windd_app_login, 
windd_app_pass, and windd_app_domain commands, respectively. 

Parameters 

YES login to the Windows NT host automatically when starting a 

WinDD session. 

NO do not login to the Windows NT host automatically (default 

setting). 

In this example, the NC automatically logs in to the WinDD host: 

windd_auto_login YES 

windd_app_name 

windd_a.pp_name published_app_name 

This command specifies the published application name of which to login and 
start when starting the WinDD session using autologin. 

Parameters 

published _app_name specifies the name of the published application in 
which to login and start when a WinDD session is 
initiated. 

In this example, the application "Notepad" is launched when WinDD is started 
using the autologin feature: 

windd_app_name notepad 
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windd_app_login 

windd_app_login username 

This command specifies the username to use when logging in to the Windows 
NT host or specified application using autologin. 

Parameters 

username specifies the username for autologin. 
In this example, the autologin username is "daves": 

windd_app_login daves 

windd_app_pass 

windd_app_pass password 

This command specifies the password to use when logging in to the Windows 
NT host or specified application using autologin. 

Parameters 

password specifies the password for autologin. 

In this example, the autologin password is "mypassword": 

windd_app_pass mypassword 

windd_app_domain 

windd_app_domain domain_name 

This command specifies the domain name to use when logging in to the 
Windows NT host or specified application using autologin. 

Parameters 

domain_name specifies the domain name for autologin. 

hostname specifies the name of the Windows NT host (up to 10 

characters). 

In this example, the autologin domain name is "Vancouver": 

windd_app_domain Vancouver 



2-1 98 NCBridge Reference Manual 



windd_size 



windd size 

windd_size <size> 

The network computer uses this entry to connect to a specific Windows NT host 
when you invoke WinDD. 

Parameters 

size specifies the resolution for the WinDD session. These values are 

allowed: 

640 specifies 640 x 480 window size (the default setting) 
800 specifies 800 x 600 window size 
1024 specifies 1024 x 768 window size 
1280 specifies 1280 x 1024 window size 

In this example, the WinDD size is 1024 x 768: 

windd_size "1024" 

windd_auto_connect 

windd_auto_connect ENABLED or DISABLED 

The network computer uses this entry to determine whether to auto-connect to 
an application server when an X session is started. 

Parameters 

ENABLED specifies auto-connect. 
DISABLED specifies no auto-connect (default). 

windd_auto_reconnect 

windd_auto_reconnect ENABLED or DISABLED 

The network computer uses this entry to determine whether to automatically 
reconnect to an application server after the user logs off during the same X 
session. 

Parameters 

ENABLED specifies to automatically reconnect after logging off. 
DISABLED specifies no automatic reconnect after logging off (default). 
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windd menubar 

windd_menubar YES or NO 

The network computer uses this entry to determine whether to display the 
menubar. If a user is using 1280 x 1024 display resolution, you may want to turn 
the menubar off. 

Parameters 

YES displays the WinDD menubar (default). 

NO specifies not to display the WinDD menubar. 

windd_entrybox 

windd_entrybox ENABLED or DISABLED 

The network computer uses this entry to determine whether to display the 
WinDD entrybox. The entrybox lists Windows NT servers available to the user. 

Parameters 

ENABLED enables the WinDD entrybox (default). 
DISABLED disables the WinDD entrybox. 

windd_auto_numlock 

windd_auto_numlock YES or NO 

Controls WinDD 's ability to set Num_Lock on mod2 through mod5 of the X 
modifiermap. Use this command only if Num_Lock is not already set on mod2 
through mod5. The modifiermap is set only when the cursor is within the 
WinDD window, and is removed when the cursor is outside the WinDD 
window. 

Parameters 

YES specifies that WinDD controls the ability to set Num_Lock on 

mod2 through mod5. This is the default setting. 

NO specifies that WinDD does not control the Num_Lock setting. 
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windd_comm_port_mapping 

windd_comm_port_mapping ENABLED or DISABLED 

This specifies whether or not to enable mapping of COM ports for use by such 
devices as printers. 

Parameters 

ENABLED enables mapping of COM ports. This is the default setting. 
DISABLED disables mapping of COM ports. 
In this example, COM port mapping is enabled: 

windd_comm_port_mapping enabled 

windd_colors 

windd_colors 16 or 256 

This specifies the color depth of the WinDD display. 
Parameters 

16 Sets color depth to 16-bits (the default setting) 

256 Sets color depth to 256-bits 

In this example, the color depth is set to 256: 
windd colors 256 
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windd_server_browser 

windd_server_browser IPaddress or hostname or NO_BROADCAST 
This parameter specifies the address or hostname of the Citrix browser. 
Parameters 

IPaddress Dotted decimal address of the Citrix browser host 
hostname Host name of the Citrix browser host 
NO_BROADCAST No ICA browsing is to be done on the local subnet. 
In this example, the default browser host is at IP address 192.86.85.100: 
windd_server_browser 192.86.85.100 

windd_server_sort 

windd_colors NAME or LOAD 

This command controls the appearance of the WinDD ICA client chooser 
screen. You can have the windd_server_sort function sort the host names by 
name or by load factor. 

Note: To use the load sort, you must have load balancing software 
running on the WinDD host. 

Parameters 

NAME Sort the list of WinDD hosts by name (alphabetical order). This is 

the default setting. 

LOAD Sort the list of WinDD hosts in order of load factor (the server 

with the lightest load is listed first). 

In this example, the color depth is set to 256: 

windd colors 256 
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windd_keysym_only 

windd_keysym_only YES or NO 

Specifies that all NCD network computer keyboards are to be supported via 
keysym translation within WinDD. (By default, most NCD network computers 
are supported via keycode translation with the exceptions of VT200/LK401 
non-North American and CUSTOM keyboards.) 

Parameters 

YES specifies that all NCD network computer keyboards are supported 

with keysym translation within WinDD. 

NO specifies that all NCD network computer keyboards are not sup- 

ported with keysym translation within WinDD. This is the default. 

windd_hot_toggle_keysym 

windd_hot_toggle_keysym <keysym_name> 

Specifies a key (in combination with the Shift and Ctrl keys) that lowers the 
WinDD client to the bottom of the client stack on the screen. This feature is helpful 
when using multiple full-screen WinDD sessions without a window manager. This 
feature is not recommended when you are running a window manager. 

Parameters 

<keysym_name> this is the name of the key to be used for the hot toggle key. 

In this example, F4 is used with Shift+Ctrl to toggle the WinDD client window: 

windd_hot_toggle_keysym F4 

windd_exit_on_logout 

windd_exit_on_logout ENABLED or DISABLED 

The network computer uses this entry to determine whether to exit the WinDD 
session on application server logout. 

Parameters 

ENABLED enables exit on logout. 
DISABLED disables exit on logout (default). 
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windd_ica_port 

windd_ica_port ica-port-number 

This parameter defines the ICA port to be used by the WinDD client. 
Sometimes, when implementing firewalls, a system administrator may decide 
to use a port other than the ICA default. This parameter tells the clients what 
port to use. 

Parameters 

ica-port-number specifies the ICA port number to be used by the local client. 
The default is 1494. 

windd_local_floppy 

windd_local_floppy ENABLED or DISABLED 

This parameter enables use of a local floppy drive on the NC using the WinDD 
ICA client. The floppy drive can be accessed as a network drive on the server. 

Parameters 

ENABLED enables floppy operation. This is the default if the hardware is 
present. 

DISABLED disables floppy operation. 

windd_outbuf_delay 

windd_outbuf_delay delay -time 

This parameter sets output buffer delay to optimize WinDD for network 
performance. Usually, on a fast network, this delay is set to minimum. On 
slower networks, this value can be increased to create larger packets, reducing 
latency introduced by packet overhead. 

Parameters 

delay-time Output buffer delay specified in milliseconds. The default setting 
is 100. 
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windd_bandwidth 

windd_bandwidth HIGH or LOW 

The bandwidth setting optimizes WinDD for the specific network on which it 
is running. It sets the output buffer delay to a pre-determined amount. 

Parameters 

HIGH Use this setting for fast networks. This is the default setting. 

LOW Use this setting for slow networks. 

windd_preload_colors 

windd_preload_colors YES or NO 

If windd_colors is set to 16, this command specifies whether the colors needed 
are preloaded when the NC is initially booted up. 

Parameters 

YES Load colors. 

NO Do not load colors (this is the default). 

windd_pixel_perfect_lines 

windd_pixel_perfect_lines ENABLED or DISABLED 

The Windows NT servers use Pixel Perfect line rendering, a different algorithm 
than X servers for line display. The difference causes only minor effects in the 
display. Enabling this parameter, however, corrects any pixel errors caused by 
the algorithm differences. 

Note: Enabling this parameter causes slower display performance. 

Parameters 

ENABLED Enable pixel correction. 

DISABLED Disable pixel correction. This is the default setting. 
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windd_compress 

windd_exit_on_logout ENABLED or DISABLED 

This parameter enables compression of traffic between the NC and host. 
Because compression takes CPU resources, this option is normally disabled on 
a fast network. On a slower network, this option may help reduce the bottleneck 
caused by the network. 

Parameters 

ENABLED enable traffic compression. 

DISABLED disable traffic compression. This is the default setting. 

windd_max_compress_disable 

windd_max_compress_disable ica_command_count 

If the windd_compress is enabled, this command specifies that 
compression should be disabled for the specified number of outgoing ICA 
commands from the WinDD client. Data after that is compressed. Compression 
may actually cause client data to expand during logon to a server. 

Parameters 

ica_command_count defines the number of outgoing ICA commands on which 
to disable compression before compression begins. The 
default setting is 0. 

ppp_auto_disconnect 

ppp_auto_disconnect ENABLED or DISABLED 

This parameter causes the PPP connection to be dropped upon session logout. 

Parameters 

ENABLED disconnect PPP connection upon logout. 

DISABLED do not disconnect PPP connection upon logout. This is the 
default. 
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windd_show_published_apps 

windd_show_published_apps YES or NO 

This parameter determines whether to show published applications (shortcuts 
to applications listed in the WinDD ICA client window). 

Parameters 

YES Show any published applications in the WinDD ICA client 

window. This is the default setting. 

NO Do not show published applications. 

windd_show_browsed_servers 

windd_show_browsed_servers YES or NO 

This parameter determines whether to display browsed servers (servers that are 
available to all users on the network). 

Parameters 

YES Display a list of browsed servers in the WinDD ICA client 

window. This is the default setting. 

NO Do not display browsed servers. 

windd_show_preferred_servers 

windd_show_preferred_servers YES or NO 

This parameter displays a list of preferred servers in the WinDD ICA client 
window. These servers appear at the top of the client window. 

Parameters 

YES Display preferred servers at top of WinDD ICA client window. 

This is the default setting. 

NO Do not display list of preferred servers. 
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RSHD Configuration 

rshd_security ENABLED or DISABLED 

If you are using a UNIX host and do not have a binary version of xpsh for the 
host, you must either compile the source for xpsh or use rsh. Using xpsh is 
preferred, since additional parameters can be set when starting a local client on 
the network computer. 

If you use rsh, then the RSHD daemon must be running on the network 
computer. This is accomplished by using the start command in the xp.cnf file 
(see start command on page 2-95). 

The RSHD daemon has a security parameter that can be configured in the xp.cnf 
file. 

Parameters 

ENABLED specifies that the.rhosts file is read from the boot path of the 
terminal. This is the default value. 

DISABLED specifies that the .rhosts file is read from the host file access path 
of the terminal. 

In this example, the .rhosts file is read from the boot path of the terminal: 

rshd_security enabled 

Authorization Key Manager 

update_authkey 

This command forces the network computer to read the authkey.dat file. This 
file is used to update several network computer authorization keys at once. For 
information about the Authorization Key Manager client, refer to your NCD 
NCBridge Installation and Configuration manual. 
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Hardware MPEG Player Configuration 

Available on XP400, NC200 and NC400 series only. 

hwmpeg dbsize 

hwmpeg_dbsize size 

Specifies the size of the Video Player' s memory buffer used when playing 
MPEG files. The buffer is configurable so you can control its size to 
accommodate larger MPEG files. Increasing the size of this buffer can help 
when transferring data across congested networks. The mpeg player can read 
from the buffer while waiting for packet transfers. The default settings, 
however, are recommended. 

Parameters 

size specifies the size of the Video Player's memory buffer (in 

kilobytes). The value defaults to 1024 and cannot be set lower 
than 1 kilobyte. If the value specified is greater than available 
memory when trying to play a file, the Video Player terminates 
and the following message displays in the network computer's 
Console: Can't init Data Reader Task. Reduce the size 
specification and try again. 

In this example, the Video Player's memory buffer is set to 1500 kilobytes: 

hwmpeg_dbsize 1500 

hwmpeg_chunksize 

hwmpeg_chunksize size 

Specifies whether the Video Player's memory buffer is divided into "chunks". 
The network fills the chunks, and the Video Player empties them as they are 
accessed. Using larger chunk sizes can increase video transfer efficiency but 
may tie up the network so that other resources have problems. This can be 
alleviated somewhat by increasing the delay but if the delay is too large, then 
the mpeg player is not able to fill the buffer fast enough and jerky video may 
result. Use the default settings for most applications. 
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Parameter 

size specifies the size of the chunks (in kilobytes) in the memory 

buffer. The default is 512 which divides the buffer into two 
chunks. If the chunk size is set to a number larger than the buffer 
size, the chunk size is truncated to one half the buffer size. The 
chunk size cannot be set less than 1 kilobyte. 

hwmpeg_chunkdelay 

hwmpeg_chunkdelay time 

Specifies how long the Video Player waits after each read request before getting 
another packet from the network. This delay should not be excessive or video 
performance may suffer. Use the default settings for most applications. 

Parameter 

time specifies the time delay (in milliseconds) the Video Player waits 

following each read request that fills a chunk. The default is 0. 

chroma_key_index 

chroma_key_index number 

The chroma_key_index is used to display graphics information from the digital 
video framebuffer instead of the standard framebuffer. 

The NC graphic system scans the standard framebuffer and interprets each color 
index as a color and sends it to the screen. However, when the graphics system 
identifies a color index in the standard framebuffer as the chroma_key_index, it 
pulls the color information from the digital video framebuffer and displays that 
color instead. Thus, the chroma_key_index defines which color index is flagged 
in the framebuffer so the NC knows when to display regular color information 
versus digital video color information. 

Parameter 

number a value of to 255. The default value is 255. 
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CSLIP Configuration 



NC Bridge supports CSLIP, but PPP enjoys wider use. We recommend using 
PPP, but these commands are available for configuring CSLIP: 

Command Page 

slip_compression 2-211 

slip_serial_port 2-212 

slip_dest_ip 2-212 

slip_src_ip 2-212 

slip_mtu 2-213 

slip_mask 2-213 

slip_def_route 2-213 

slip_compression 

slip_vj_compression ENABLED or DISABLED or ALLOWED 

Specifies whether TCP/IP headers are compressed using Van Jorgenson 
compression while sending and receiving data. 

Parameters 

ENABLED specifies that compression is used when transmitting and 
receiving data (default setting). 

DISABLED specifies that compression is disabled. 

ALLOWED specifies no compression when transmitting data, but ready to 
receive compressed packets. 

In this example, compression is disabled: 

slip_compression DISABLED 
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slip_serial_port 

slip_serial_port SERIAL_PORT_0 or SERIAL_PORT_l 

Specifies the network computer's port number on which to use CSLIP. 

Parameters 

SERIAL_PORT_0 specifies that the CSLIP uses Serial Port (default). 

SERIAL_PORT_l specifies that the CSLIP uses Serial Port 1. 

In this example, CSLIP starts over Serial Port 1 

slip_serial_port SERIAL_P0RT_1 

slip_dest_ip 

slip_dest_ip hostname or IP_address 

Specifies the host to which you are connecting. Enter the host name or its address. 
Parameters 

hostname specifies the hostname. 

IP_address specifies the host's IP_address in decimal dot format. 
In this example, the host is nevada: 
slip_dest_ip "nevada" 

slip_src_ip 

slip_src_ip nc_name or IP_address 

Specifies the network computer's name or IP address. IP addresses can be 
assigned dynamically by the host when dialing into a modem pool. To have the 
address assigned, uncomment this command and enter the null string "". 

Parameters 

nc_name specifies the network computer's name. 

IP_address specifies the network computer's address in decimal dot format. 

In this example, the network computer's name is sapphire: 

slip_src_ip "sapphire" 
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slip_mtu 

slip_mtu value 

Specifies the maximum transmission unit for data transmission. 

Parameter 

value specifies the network computer's MTU value. This value must 

match the server' s MTU value. 

In this example, the MTU value is 1000: 

slip_mtu 10 

slip mask 

slip_mask net mask 

Specifies the subnet mask used for the CSLIP session. 

Parameter 

net mask specifies the subnet mask value used for the CSLIP session. 
In this example, the subnet mask is 255.255.0.0: 

slip_mask "255.255.0.0" 

slip_def_route 

slip_def_route YES or NO 

Specifies whether the destination IP address (entered with the slip_dest_ip 
command) is added as the gateway default in the gateway table. 

Parameters 

YES specifies that the destination IP address is added as the gateway 

default in the gateway table. 

NO specifies that the destination IP address is not added as the 

gateway default in the gateway table. 

In this example, the destination IP address is added to the gateway table as the 
default gateway: 

slip_def_route YES 
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PPP Configuration 

The Point-to-Point Protocol (PPP) has these configurable settings: 
Command Page 

ppp_session_name 2-215 

ppp_connect_type 2-216 

ppp_app_hostaddr 2-216 

ppp_dialup_number 2-217 

ppp_port 2-217 

ppp_local_ip_addr 2-218 

ppp_disable_all 2-218 

ppp_disable_ac 2-219 

ppp_enable_debug 2-219 

ppp_asyncmap 2-220 

ppp_disable_pap 2-220 

ppp_disable_chap 2-221 

ppp_remotename 2-221 

ppp_nodefaultroute 2-222 

ppp_proxyarp 2-222 

ppp_connect_method 2-223 

ppp_connect_string 2-223 

ppp_disconnect_string 2-224 

ppp_login_username 2-224 

ppp_login_password 2-224 

ppp_script_name 2-225 

ppp_app_username 2-225 

ppp_app_password 2-226 

ppp_app_domain 2-226 

ppp_disable_pc 2-226 

ppp_disable_mm 2-227 
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Command Page 

ppp_disable_am 2-227 

ppp_lcp_restart 2-227 

teklogin_timeout 2-228 

teklogin_require_login 2-228 

teklogin_save_passwords 2-229 

teklogin_show_sessions_in_launcher . 2-229 

teklogin_force_fullscreen_windd 2-230 

teklogin_default_session 2-230 

teklogin_close_on_connect 2-230 

Note: The default session for all PPP commands is 1. 

ppp_session_name 

ppp_session_name name [1-8] 

Sessions can be "named" or not. Only sessions that are "named" show up in 
TekLogin or the Launcher menu. The last parameter [1-8] designates the 
session to apply the name. 

Parameters 

name a character string that defines the session name. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the session name "mysession" is applied to session two: 

ppp_session_name Mysession 2 
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ppp_connect_type 

ppp_connect_type action [1-8] 

This tells PPP what to do after a connection is made. If the command 
ppp_app_hostaddr is set, it is used in conjunction with this one. 

Parameters 

action instructs the PPP client what to do after a connection is made. 

Choices are NONE, ICA_HOST (the default value), 
HOSTMENU, XDMCP_DIRECT, and TELNET. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, connect type "HostMenu" is applied to session three: 

ppp_connect_type HostMenu 3 

ppp_app_hostaddr 

ppp_app_hostaddr IP address [1-8] 

Specifies the host to be used as a port for the command 

ppp_connect_type. 

Parameters 

IPaddress dotted decimal IP address. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, IP address 192.86.85.100 is applied to session three: 

ppp_app_hostaddr 192.86.85.100 3 



2-21 6 NCBridge Reference Manual 



ppp_dialup_number 

ppp_dialup_number 

ppp_dialup_number number [1-8] 

This command allows you to assign a different phone number to each session. 

Parameters 

number numeric string representing the telephone access number of the 

modem. This value can be up to 15 digits. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the following dialup number is applied to session 1 : 

ppp_dialup_number 13605551212 1 

ppp_port 

ppp_port port [1-8] 

Port entry specifies which port is to be used for the PPP connection. If no port 
is specified, port selection is taken from NVRAM settings. This port entry can 
be used to disable PPP from starting. 

Parameters 

port SERIAL_PORT_0 (port 0) or SERIAL_PORT_l (port 1 , the 

default). 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, Serial Port is used for the PPP port in session 4: 

ppp_port serial_port_0 4 
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ppp_local_ip_addr 

ppp_local_ip_addr IPaddress [1-8] 

This command specifies a local IP address for the PPP connection. 

Parameters 

IPaddress dotted decimal address used for the PPP connection. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the IP address 192.86.85.100 is used for the PPP connection in 
session 5 : 

ppp_local_ip_addr 192.86.85.100 5 

ppp disable all 

ppp_disable_all [1-8] 

Disables Address/Control field compression negotiation, Protocol field 
compression, VJ compression, Proxy ARP, default route, asyncmap 
negotiation, IP address negotiation, magic number negotiation, MRU 
negotiation and Rejects pap authentication requests and chap authentication 
requests. And pap and chap authentication for peer not required. Add this 
command to the xp.cnf file to disable all previously described features. 

Parameters 

1-8 Session number. If none is specified, the default value of 1 is used. 

Here is an example where the features specified above are disabled in session 7: 

ppp_disable_all 7 
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ppp_disable_ac 

ppp_disable_ac [1-8] 

Disables Address/Control compression (the default is ENABLED). Add this 
command to the xp. cnf file to disable Address/Control compression. 

Parameters 

1-8 Session number. If none is specified, the default value of 1 is used. 

Here is an example where address/control compression is disabled in session 2: 

ppp_disable_ac 2 

ppp_enable_debug 

ppp_enable_debug [1-8] 

Enables debugging output. By default, debug output is disabled. Add this 
command to the xp. cnf 'file to enable the debug feature. 

Parameters 

1-8 Session number. If none is specified, the default value of 1 is used. 

Here is an example where debug features are enabled in session 8: 

ppp_enable_debug 8 
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ppp_asyncmap 

ppp_asyncmap value [1-8] 

Sets async map value. By default, no asyncmap value. The asyncmap describes 
which control characters cannot be successfully received over the serial line. 
The PPP daemon asks the peer to send these characters as a 2-byte escape 
sequence. 

Parameters 

value 32-bit hex number. Each bit represents a character to escape. Bit 

represents 0x00 and bit 31 represents Ox If. If multiple options 
are given, the values are ORed together. If an async option is not 
given, no async character map is negotiated in the receive 
direction; all control characters are escaped. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the character 0x00 is escaped for session 5: 

ppp_asyncmap 00000001 5 

ppp disable pap 

ppp_disable_pap [1-8] 

Doesn't allow UPAP authentication with peer. By default, PPP allows UPAP 
authentication with peer. Add this command to the xp.cnf file to disable UPAP 
authentication. 

Parameters 

1-8 Session number. If none is specified, the default value of 1 is used. 

Here is an example where UPAP authentication is disabled for session 2: 
ppp_disable_pap 2 
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ppp_disable_chap 

ppp_disable_chap [1-8] 

Doesn't allow CHAP authentication with peer. By default, PPP allows CHAP 
authentication with peer. Add this command to thexp.cn/file to disable CHAP 
authentication. 

Parameters 

1-8 Session number. If none is specified, the default value of 1 is used. 

Here is an example where CHAP authentication is disabled for session 3: 

ppp_disable_chap 3 

ppp_remotename 

ppp_remotename remote _host_name [1-8] 

Name of the peer for authentication. 

Parameters 

remote _ho st _name 

character string representing name of remote host used for peer 
authentication. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the PPP remote host uses the name "myhost" for session 4: 

ppp_remotename myname 4 
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ppp_nodefaultroute 

ppp_nodefaultroute YES or NO [1-8] 

Setting the addresses on a PPP interface is sufficient to create a host route to the 
remote end of the link. Sometimes it is desirable to add a default route through 
the remote host, as in the case of a machine whose only connection to the 
Internet is through the PPP interface. The "defaultroute' option causes pppd to 
create such a default route when IPCP comes up, and delete it when the link is 
terminated. This has been enabled by default. For users who have both Ethernet 
and PPP connections, they would not like this option enabled by default. 

Parameters 

YES does not set PPP connection as default route while connection is 
established (default setting). 

NO sets PPP connection as default route while connection is established 
(default setting). 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the PPP connection does not establish a default route for session 7: 

ppp_nodef aultroute YES 7 

ppp_proxyarp 

ppp_proxyarp YES or NO [1-8] 

On a server machine connected to a LAN, in order to allow other hosts to 
communicate with the remote host. The "proxyarp' option causes pppd to look 
for a network interface (an interface supporting broadcast and ARP, which is up 
and not a point-to-point or loopback interface) on the same subnet as the remote 
host. If found, pppd creates a permanent, published ARP entry with the IP 
address of the remote host and the hardware address of the network interface 
found. By default, no proxy arp. 

Parameters 

YES enables PPP proxyarp. 

NO disables PPP proxyarp (the default setting). 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, PPP proxyarp is enabled: 
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ppp_proxyarp YES 

ppp_connect_method 

ppp_connect_method DIRECT-CONNECT or DIAL-OUT [1-8] 

Connect method for PPP. 

Parameters 

DIRECT-CONNECT connected directly through RS-232 cable. 

DIAL-OUT connect via modem (default value). 

1-8 Session number. If none is specified, the default value of 

1 is used. 

In this example, the connect method is via modem for session 2: 

ppp_connect_method dial-out 2 

ppp_connect_string 

ppp_connect_string string [1-8] 

This is the vendor-dependent connect string used for the modem. 

Parameters 

string Character string used for PPP connection. Default ATDT. A 

maximum of 15 characters is allowed. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the connect string is "ATDT", a Hayes-compatible string for 
accessing dial tone for session 3: 

ppp_connect_string ATDT 3 
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ppp_disconnect_string 

ppp_disconnect_string string [1-8] 

This is the vendor-dependent disconnect string for the modem. 

Parameters 

string Character string used for PPP disconnect. Default +++ATDT. A 

maximum of 15 characters is allowed. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the disconnect string is "+++ATDT", a Hayes-compatible 
string for session 6: 

ppp_disconnect_string +++ATDT 6 

ppp_login_username 

ppp_login_username username [1-8] 
This command sets the username for the specified session. 
Parameters 

username Character string defining the username. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the PPP login username is "daves" for session 1 : 
ppp_login_username daves 

ppp_login_password 

ppp_login_username password [1-8] 
This command sets the password for the specified session. 
Parameters 

username Character string defining the password. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the PPP login password is "mypassword" for session 1 : 
ppp_login_pas sword mypassword 
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ppp_script_name 

ppp_script_name scriptname [1-8] 

This command sets the script name for the specified session and is used to 
override the default script used in logging in to some PPP servers. The scripts 
are found in .../config/script. 

Parameters 

scriptname Character string used for PPP disconnect. Default +++ATDT. A 
maximum of 15 characters is allowed. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the script named "login" is used for session 2: 

ppp_script_name login 2 

ppp_app_username 

ppp_app_username username [1-8] 

This command sets the username for the PPP application launch, if any. 
Parameters 

username Character string defining the username. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the PPP application username is "daves" for session 3 : 
ppp_app_username daves 3 



NCBridge Reference Manual 2-225 



53 



Chapter 2 Remote Configuration 

ppp_app_password 

ppp_app_username password [1-8] 

This command sets the password for the PPP application launch, if any. 
Parameters 

username Character string defining the password. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the PPP application password is "mypassword" for session 3 : 
ppp_app_pas sword mypassword 3 

ppp_app_domain 

ppp_app_domain domain_name [1-8] 

This command sets the NT domain used during the application launch of a 
WinDD client, if any. Used with ppp_app_username and ppp_app_password. 

Parameters 

domain_name Character string defining the username. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the NT domain used for application launch is "hostl" for 
session 3: 

ppp_app_domain hostl 3 

ppp_disable_pc 

ppp_disable_pc [1-8] 

This command disables protocol field compression negotiation in both transmit 
and receive direction for the specified session. 

Parameters 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, protocol field compression is disabled for session 2: 

ppp_disable_pc 2 
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ppp_disable_mn 

ppp_disable_mn [1-8] 

This command disables magic number negotiation. With this option, pppd cannot 
detect a looped-back line. Use this option only if the peer is not functioning 
correctly. 

Parameters 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, magic number negotiation is disabled for session 4: 

ppp_disable_mn 4 

ppp_disable_am 

ppp_disable_am [1-8] 

This command disables asyncmap negotiation, forcing all control characters to 
be escaped for both transmit and receive directions. 

Parameters 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, asyncmap negotiation is disabled for session 5: 

ppp_disable_am 5 

ppp_lcp_restart 

ppp_lcp_restart n [1-8] 

This command sets the LCP restart interval (retransmission timeout) to n 
seconds. 

Parameters 

n Number of seconds used for timeout value. The default is 3. 

1-8 Session number. If none is specified, the default value of 1 is used. 

In this example, the LCP restart interval is set to 2 seconds for session 7: 

ppp_lcp_restart 2 7 
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teklogin_timeout 

teklogin_timeout time 

This command sets the amount of time in seconds before the TekLogin client 
automatically initiates the default session. 

Parameters 

time The time in seconds. Setting this value to zero disables the 

feature. The default value is 30 seconds. 

In this example, the Teklogin timeout is set to 30 seconds: 

teklogin_timeout 3 

teklogin_require_login 

teklogin_require_login YES or NO 

The TekLogin function normally caches the last username/password 
combination so that it can be used again for the next session. This is not 
necessarily desirable if the terminal is being used by multiple users. 

Parameters 

YES Do not cache the last username/password combination. 

NO Cache the last username/password combination (default). 

In this example, the login is not cached: 

teklogin_require_login YES 
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teklogin_save_passwords 

teklogin_save_passwords YES or NO 

This command is similar to "teklogin_require_login" but can be used to disable 
the saving of passwords in non-volatile memory on the terminal. The last 
username is retained. 

Parameters 

YES Save password of last login (default). 

NO Do not save password of last login. 

In this example, the password of the last session is not saved: 

teklogin_save_passwords NO 

teklogin_show_sessions_in_launcher 

teklogin_show_sessions_in_launcher YES or NO 

The is an option that allows all "named" sessions (see ppp_session_name) to be 
displayed in a menu as a part of the launcher. This is an easy way to gain access 
to multiple sessions. 

Parameters 

YES Show named PPP sessions in launcher. 

NO Do not show named PPP sessions in launcher (default). 

In this example, PPP session names are displayed in the Launcher: 

teklogin_show_sessions_in_launcher YES 
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teklogin_force_fullscreen_windd 

teklogin_force_fullscreen_windd YES or NO 
Convenience option to force all WinDD sessions to be full screen. 
Parameters 

YES Display all WinDD sessions in full screen. 

NO Do not display all WinDD sessions in full screen (default). 

In this example, all WinDD sessions are shown full-screen: 
teklogin_f orce_f ullscreen_windd YES 

teklogin_default_session 

teklogin_default_session session_no. 

Selects which session is initially displayed by TekLogin. 

Parameters 

session_no. The session number initially displayed by TekLogin. The default 
value is 1 . 

In this example, the default TekLogin session is number 4: 

teklogin_def ault_session 4 

teklogin_close_on_connect 

teklogin_close_on_connect YES or NO 

Controls whether TekLogin remains visible after it has completed a connection. 

Parameters 

YES TekLogin remains visible after the connection is completed. 

NO TekLogin does not remain visible after the connection is 

completed (default). 

In this example, the Teklogin screen remains visible after connection: 

teklogin_close_on_connect YES 



2-230 NCBridge Reference Manual 



Script Variable Configuration 



Script Variable Configuration 

script_variable 

script_variable variable_name value 

This command defines variables and values used with scripts. Each network 
computer can use unique script variables and/or values. 

Note: For information about the Scripting Language, see 
Appendix D, Scripting Language. 

Parameters 

variable _name specifies the name of the variable. This name can be placed 
in a script and then accessed when the script executes. 

value specifies the value used for the variable defined above. One 

variable can have multiple values on different network 
computers. This allows you to customize network 
computer tasks. 

In this example, the variable is Phone and the value is 9837813. The variable 
Phone can be added to a script and when encountered, the phone number 
9837813 is accessed. The variable Phone can be used in different xp. cnf files on 
different network computers with different phone numbers as the value. This 
allows the network computers to use different phone numbers. 

script_variable "Phone" "9837813" 
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Setup 



Setup is a local client on the Network Computer which displays the current setup 
of the NC in a windowed interface. Through this interface, you can configure 
network computer settings, establish communication connections with remote 
hosts, and monitor network computer operations. 

Use Setup to configure the NC terminal to your liking. Take common settings 
you want to apply to all terminals or to groups of terminals and apply them to 
the xp.cnf file. This file can then be used to configure other network computers, 
eliminating the need to repeat the configuration process for each network 
computer. The file can be edited and renamed as appropriate to accommodate 
special settings. Refer to the section titled Saving Setup Settings to a File on 
page 3-11 for details. 

Note: It is best to edit the xp.cnf file directly. Using the "Save to File" 
feature of Setup can create extraneous (but not harmful) data 
that can make subsequent changes to the xp.cnf file more 
difficult to perform. 

An NC's Setup can be started and displayed on a remote network computer or 
host using xpsh. Once started, you can use Setup as if it were on the NC's local 
display. Refer to the section titled Using Remote Setup on page 3-12 for details. 

Table 3-1 Setup Key and Key Sequences for Client Launcher (or Setup) 



Keyboard Type 


Press 


Windows 95 


SHIFT-Pause 


101/102 with Setup 


Setup key 


101/102 with Pause 


SHIFT-Pause 


Sun keyboard 


ALT-GRAPH-HELP 


3270 keyboard 


Right ALT-ExSel (The left ALT key does not work.) 


LK401 


F3 key 


UNIX keyboard 


Alt-Graph 



NCBridge Reference Manual 



3-1 



53 



Chapter 3 Setup 



The Setup Main Menu 



To start Setup, select Setup from the Client Launcher. The Setup Main Menu 
shown in Table 3-1 displays. 



EH3H" 



Configuration 
Sumiuunr& 



Network tablet 
4r>d ''mi: 



Hnrth Vun eric an 



Keyboard: 



Screen Saver 
Restricted SelLi^ 
Setup Password 



Intflpg wfth Pm aey Nationally 



north American 



S**e Settings 

I., IIUIIAM 



Load Previous 
Settings 



Cleat 
Setting* 



Reset 
Server 



Reboot 



Ddt 
Setup 



Menu 
Bar 



Menu 
Input 
Area 



Function 
Bar 

Message 
Box 



Figure 3-1 The Setup Main Menu 

Note: The appearance of the Setup window on your network computer 
may differ from this example, depending on which network 
computer model you have. 

The Setup Main Menu is made up of four different areas: the Menu Bar, the 
Menu Input Area, the Function Bar, and the Message Box. There are three Setup 
Menus located on the Menu Bar: Configuration Summaries, Network Tables 
and Utilities, and Statistics. Each of these menus contain additional options on 
pull-down menus described later in this chapter. 

The Message Box provides information about the function of the commands on 
this menu. When you place the cursor over or near a button, a message appears 
in the Message Box describing the the purpose of the command. 
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Menu Bar 

The Menu Bar displays the available Setup pull-down menus. Pull-down menus 
are presented for Configuration Summaries, Network Tables and Utilities, and 
Statistics. Each pull-down menu and available options are listed in The Setup 
Menus section later in this chapter. 

Menu Input Area 

The Menu Input Area is located directly below the Menu Bar. The Menu Input 
Area for the Main Menu contains these options: 

Note: The Menu Input Area for different menus have different options 
and settings. 

Model 

Displays the network computer model number. 
Version 

Displays the version number of the NCBridge software. 
Level 

Displays the level number of the NCBridge software. 
Language 

Specifies the language used to print local client messages. The options are: 
North American, United Kingdom, French, Swedish, Danish, Norwegian, 
German, Italian, Spanish, Swiss-German, Katakana, and Finnish. 
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Keyboard Type 

Specifies the keyboard type. The option you use depends on your keyboard 
and the key variations you want: 

• 101/102 with Setup key specifies the IBM 101- or 102-key keyboard where 
the Setup key invokes the Client Launcher. 

• 101/102 with Pause key specifies the IBM 101- or 102-key keyboard where the 
Shift-Pause keys invoke Setup. Table 3-2 shows differences between the Setup 
and Pause keyboards. This setting also applies to Windows 95 keyboards. 

• VT200/LK401 offers four options of the VT200/LK401 -style keyboard. 
Each option has different default key assignments. Table 3-3 shows keycap- 
to-keysym mapping for each option. 

• UNIX specifies the UNIX keyboard (i.e., the Sun-type IV keyboard). When 
using the UNIX keyboard, the only available nationality is North American. 

• 3270 specifies the 3270-type keyboard. 

• Sun V specifies the Sun V keyboard. 

• Custom specifies a custom keyboard. 

Note: Refer to Appendix B, Keyboards, for more information about 
keyboards, keycodes, and default keysym mappings. 



Table 3-2 101/102 Setup and 101/102 Pause Keyboard Differences 




Keycap 


Keycode 


101/102 Setup 


101/102 Pause 


Non-shifted value 
Shifted value 


Linefeed 


95 


Linefeed 


Print 
Linefeed 


Non-shifted value 


Break 


103 


Break 


Cancel 


Non-shifted value 
Shifted value 
Alt_GR value 


Setup 


106 


TekSetup 
Pause 


Pause 

TekSetup 

Break 


Non-shifted value 
Shifted value 


Caps Lock 


28 


Caps_Lock (101 Setup) 
Control_L (102 Setup) 


Control_L 


Non-shifted value 


Control 


25 


Control_L (101 Setup) 
Caps_Lock (102 Setup) 


Caps_Lock 
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Table 3-3 VT200/LK401 Keyboard Keycap-to-Keysym Mappings 



Keycap 


ULTRIX (ESC) 
Keyboard 


VMS 
(F11) Keyboard 


X (ESC-BS-LF) 
Keyboard 


X(F11-F13) 
Keyboard 


Unshifted 
Function 


Shifted 
Function 


Unshifted 
Function 


Shifted 
Function 


Unshifted 
Function 


Shifted 
Function 


Unshifted 
Function 


Shifted 
Function 


Fl 


Fl 


Fl 


Fl 


Fl 


Fl 


Pause 


Fl 


Pause 


F2 


F2 


F2 


F2 


F2 


F2 


Print 


F2 


Print 


F5 


F5 


F5 


F5 


F5 


F5 


Break 


F5 


Break 


Fll 


Escape 


Escape 


Fll 


Fll 


Escape 


Fll 


Fll 


Escape 


F12 


F12 


F12 


F12 


F12 


BS 


F12 


F12 


BS 


F13 


F13 


F13 


F13 


F13 


LF 


F13 


F13 


LF 


Do 


Menu 


Menu 


Menu 


Menu 


Menu 


Menu 


Execute 


Execute 


Shift_R 


Shift_L 


Shift_L 


Shift_L 


Shift_L 


Shift_L 


Shift_L 


Shift_L 


Shift_L 



Mapping File 

Specifies the mapping file used for the custom keyboard. This entry appears 
only if the Keyboard Type is set to Custom. 

DP Mode 

Enables the Data Processing keys on international LK401 keyboards. This 
entry appears only if you set the Keyboard Type to one of the LK401 
keyboards. The options are On and Off. (This option is not available on all 
network computer models.) 

Compose Sequences 

Specifies whether compose sequences are loaded. This entry appears only if 
the Keyboard Type is set to one of the LK401 keyboards. The options are No 
and Yes. 

Nationality 

Specifies the nationality of the keyboard. The options are: North American, 
United Kingdom, French, Swedish, Danish, Norwegian, German, Italian, 
Spanish, Swiss-German, Katakana, Finnish, and Follows Language. 
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Screensaver 

Dims the screen after 10 minutes of inactivity. The options are Yes, No, and 
Powersave, a more energy efficient screen saver feature. Powersave has 
three phases: 

Stand-by After 10 minutes of inactivity, the screen blanks and returns 
immediately when a key is pressed. 

Suspend After the screen has been on Stand-by for 10 minutes, the screen 
remains blank and goes into Suspend mode, using less energy 
than in Stand-by mode. When a key is pressed, the screen display 
returns after a few moments. 

Off After the screen has been in Suspend mode for 10 minutes, the 

screen remains blank and goes into Off mode, using minimum 
energy. When a key is pressed, the screen display returns but 
takes longer than in Stand-by or Suspend modes. 

You can use the xset command to change the default 10 minute time limit. 

Note: The Powersave feature is not available on the XP330 series 
network computers. Also, to use power saving features, the 
monitor used must be "Energy Star" compliant. 

Restricted Setup 

Limits access to certain Setup parameters. The options are On and Off. You 
must set a new password in Setup Password before you can set Restricted 
Setup to On. You are prompted for the password once per menu. For 
example, if you select a Configuration Summaries menu option, you are 
prompted for the password. Then if you select a Statistics menu option, you 
are prompted again. Table 3-4 lists the fields that are not restricted. 
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Table 3-4 Setup Fields That Are Not Restricted 



Menu 


Submenu 


Fields 


Main 




Language 
Keyboard Type 
Nationality 
Screen Saver 
Reset Server 
Exit Setup 


Configuration 
Summaries 


X Environment 


Retain X Settings 

Backing Store 

Default Visual 

Old DW Compatibility 

Font Cache 

Empty Font Cache 


Statistics 


All 


Update Statistics 




TDEnet 


Clear TDEnet Counters 


All 


All 


Return to Main Menu (unless you 
are already at the Main Menu). 



Note: Not all submenus and fields in Table 3-4 are available in all 
network computer models. 

Setup Password 

Setup Password lets you enter a password that limits access to Restricted 
Setup parameters. You must set a new password before you can set 
Restricted Setup to On. To clear the password, use the setup password 
command in the remote configuration file (xp.cnf) to set the password to 
"" (the empty string). 
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The Function Bar 

The Function Bar contains items for selecting activities specific to a given 
window. Moving the pointer on an item on the function bar displays help 
information in the message box. 

The Function Bar includes these radio buttons: 

Save Settings to NVRAM which stores the current settings in the local 
NVRAM. 

Load Previous Settingswhich loads current NC NVRAM settings. 

Clear Settings which loads current NVRAM to the factory default. Table 3-5 
lists some of the fields that are affected by Clear Settings. 

Table 3-5 Fields Affected by Clear Settings 



Menu 


Submenu 


Fields 


Factory Default 


Main 




Screen Saver 


On 


Configuration 
Summaries 


LAT 


Service Directory Size 
Circuit Timer (msecs) 
Connect Timer 
Keepalive Timer 
Retransmit Timer 
Retransmission Limit 


120 

80 msecs 

16 

20 

200 

8 




Peripherals 
(both ports) 


Baud Rate 
Data Bits 
Flow Control 
Parity 
Stop Bits 


19200 

8 

None 

None 

1 




X Environment 


Backing Store 
Host Connect Method 
Retain X Settings 
XDMCP Connect Method 


Enabled 
XDMCP Direct 
Yes 
Disabled 



Reset Server which closes all open connections and resets the X server 
according to current settings. 

Reboot NC which reboots the network computer. 

Exit Setup which exits the Setup client. 
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Moving and Editing in Setup 

This section describes how to maneuver in Setup, including selecting menus 
and options, moving and sizing the Setup window, and adding and editing 
entries in text fields. 

Selecting Setup Menus and Options 

Use the mouse to select the Setup Menu you want, and then the options. 

• To display one of the Setup Menus (such as Statistics), or to select an option 
in the Menu Input Area (such as Language), position the pointer on a menu 
item, click a mouse button and drag. 

• To select a setting, such as Screen Saver, position the mouse pointer on the 
setting, click a mouse button, and drag to the selection of your choice. 

• To perform a function, such as Save Current Settings, position the mouse 
pointer on the function and click a mouse button. This writes the current 
settings into NVRAM which can only be cleared out with new settings saved 
in NVRAM or by entering the NVFactory command (see Chapter 4, Boot 
Monitor, for more information.) 

Moving and Sizing the Setup Window 

If a window manager is running, the Setup window can be moved and sized 
using the mouse. The new location and size is in effect for the current Setup 
session only. When Setup is closed and opened again, it returns to its default 
location and size. 

• To move the Setup window, position the mouse pointer on the Setup title bar 
(above the Menu bar), click a mouse button, and drag the window to a new 
position. 

• To change the size of the Setup window, position the mouse pointer on any 
corner of the window, click a mouse button, and drag to a new size. The 
window and fonts automatically scale to accommodate the new size. 
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Adding Entries in Text Fields 

Setup contains several text fields where you enter configuration information. 
For example, the Network Tables and Utilities menu items contain several text 
fields that allow you to add and delete entries. The entries in the text fields 
affect only the current session unless you select the Save Current Settings 
button. (Font directory changes, however, cannot be saved in NVRAM.) 

• To add an entry in a text field, position the cursor on the field, type the entry, 
and press Enter or Return. 

• You can also edit an existing entry. When you select an entry, it displays in 
the text field where you can edit it and add it as a new entry. 

Table 3-6 shows the editing keys available for making changes. 

Editing in Text Fields 

The editing features listed in Table 3-6 are available in text fields. 
Table 3-6 Editing Functions for IBM and VT220 Keyboards 



Press this: 


To: 


Button 1 


Position the cursor in the text field. Use this button also to cut text to the Cut buffer. Select 
the text by pressing Button 1 and dragging to highlight the text to place in the cut buffer. 


Button 2 


Paste the contents of the Cut buffer at the cursor position. 


Left arrow 


Move the cursor one character to the left. 


Right arrow 


Move the cursor one character to the right. 


Backspace 


Delete the character to the left of the cursor. 


Control-a 


Move the cursor to the beginning of the line. 


Control-e 


Move the cursor to the end of the line. 


Control-k 


Delete all text from cursor position to the end of the line. 


Control-u 


Clear all text from the text field. 


Control-r 


Restore the contents of the window when editing an existing entity. 


Delete 


Delete current character (IBM keyboards), or previous character (VT220 keyboards). 


Insert 


Toggle between insert and overwrite mode. When in insert mode, the cursor is an under- 
line; when in overwrite, the cursor is a square block. 
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Saving Setup Settings to a File 



Setup entries can be saved to a host-based file which can then be used to 
configure one or more network computers. This is a good utility for creating an 
initial remote configuration file or an individual, customized remote 
configuration file. 

Save Settings to File is located on the Configuration Summaries menu. You 
need to specify the host name or address, the access method, and the full path 
and file name. When you are ready to write the file, click on the Save Settings 
to File button. 

• If the specified file already exists, Setup overwrites it. Unless you are sure 
you wish to overwrite the file, you may want to specify a temporary file 
name or create a backup of your previous file. 

• If using TFTP as the access method, the new file must exist before 
performing the Save Settings to File and must have world-read and -write 
permissions. If using NFS as the access method, the Save Settings to File 
option creates the file, but the directory where the file is written must have 
world-read and -write permissions. 

• Only settings that are common between the remote configuration file and the 
Setup utility are saved to the file. Features that are only available in the 
remote configuration file (xp.cnj) must be manually added to the file written 
by Setup. These remote configuration commands are examples of some of 
the commands which are not available in Setup: 



add_lat_group_codes 

boot_config_type 

cterm_menu_entry 

delete_lat_group_codes 

do_flash 

flash_console 

flash_do_not_compress 

flash_feature 

gateway_entry 

include_host_access 

telnet_exit_on_logout 

video_source 

video_encoding 

video_field_duplicate 

enable xv 



ip_host_entry 

keymap_file_list_entry 

keysym_action_entry 

nfs_entry 

preload 

save_current_settings 

select (except computer name) 

snmp_comm_list 

snmp_trap_list 

spooler_auth_host 

enable_tftp_daemon 

video_attribute_group 

video_volume 

video window size 



spooler_auth_user 

spooler_local_queue 

start 

start_session 

tdenet_host_entry 

telnet_menu_entry 

unsupported_feature_warnings 

vendor_string 

vms_menu_entry 

xdmcp_menu_entry 

video_source_label 

video_visual_preference 

video_switch 

video_window_position 
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Using Remote Setup 

xpsh -display nc_name:0 setup 

A network computer's Setup and Console window can also be started and 
displayed on a remote network computer or host using xpsh. Once started, 
you can use Setup to configure network computer settings, establish 
communication connections, and monitor network computer operations. 

For example, to access a network computer' s Setup from any other remote 
XI 1 device using C shell, enter: 

setenv TEKSETUP_DISPLAY display _device:0 
xpsh -display nc_name ■. setup 

If using a different type of shell tool, enter: 

xpsh -display nc:0 -xpenv "TEKSETUP_DlSPLAY=display_device:Qi" setup 

Example: 

xpsh -display 192.43.154.66:0 -xpenv "TEKSETUP_DISPLAY=192.43. 154.4:0" setup 

where nc is the remote network computer whose Setup and Console window 
is accessed, and display _device is the network computer or host where Setup 
is to display. Use IP or DECnet addresses if the remote network computer 
does not know the host name of the display device (set up in the Internet Host 
Table or TDEnet Host Table in Setup). 

If the network computer user currently has Setup started, it is not accessible 
remotely via xpsh. Likewise, if a remote network computer or host has Setup 
open via xpsh, it is not available to the network computer user. 

Note: To prevent other users from accessing your network computer 's 
Setup and resetting the server, set enable _access_control to Yes 
(in either the xp.cnffile or in Setup). 
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The Setup Menus 

The Setup menus allow you to: 

• Manipulate configuration parameters 

• Configure network table entries 

• View network statistics 

Each of the Setup menus and options are listed on the pages that follow. 

Note: Not all Submenus and fields in Table 3-7 are available in all 
network computer models. 

Table 3-7 Setup Menus 

Menu Description 

Main The main menu 

Configuration Summaries Contains configuration menus for Boot, TCP/IP, X Environment, 

Peripheral Ports, Host File Access, TDEnet, Input Extension, 
LAT, CSLIP, Session Manager, PPP, and Save Settings to File. 

Network Tables and Utilities Contains the Network Utilities menu, table menus for Gateway, 

NFS Mount, Internet Host, Display Access, Font Directory, 
TDEnet Host, and LAT Group Codes, a way to open the 
Console window, and Script Parameters. 

Statistics Contains the Options display menu and statistical menus for 

Memory, Hardware, TCP/IP, and TDEnet. 
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Configuration Summaries Menu 

Note: If a Token-Ring interface is present, the selections for TDEnet 
and LATdo not appear. 

This is where you access the configuration menus for Boot, TCP/IP, 

X Environment, Peripheral Ports, Host File Access, TDEnet, Input Extension, 

LAT. CSLIP, and Save Settings to File. 

Table 3-8 Configuration Summaries Menu Items 
Menu Item and Options Description 



Boot Configuration Menu 



Configuration menu for the boot process. The boot ROM version 
is displayed at the top of the Boot Configuration screen. 



Boot Method (Primary and 
Secondary) 

Boot Host Name (Primary 
and Secondary) 

Boot Path (Primary and Sec- 
ondary) 



Specifies boot method. 



Boots from this host or IP address. 



Full pathname to the boot file. 



Determine IP Address From Specifies where to get the internet protocol address. 



Enable Boot Delay 



Verbose Boot Messages 



Specifies whether the network computer waits before automati- 
cally booting, and whether the delay is random or specified in the 
seconds field. 

Enables or disables verbose file access messages at boot time 



TCP/IP Configuration Menu Configuration menu for TCP/IP. 



NC Name 
NC IP Address 



Specifies the network computer name. 
Specifies the IP address. 



Subnet Mask 
Broadcast Address 
Enable Broadcasts 



Determines subnet mask (with IP address). 

Uses this value for a broadcast. 

Specifies whether to accept or ignore all broadcast packets. 
(Turning broadcasts off may cause some networks to fail.) 



Default Telnet Host 
Name Server 1-3 
Enable Name Service 



Specifies either a host name or IP address. 

Specifies primary, secondary, and tertiary (third) name servers. 

Specifies whether name service is used to obtain IP addresses 
when host names used in the Internet Host Table. 
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Table 3-8 Configuration Summaries Menu Items (continued) 



Menu Item and Options 


Description 


DNS timeout 


Sets initial timeout (seconds) the name server waits to reply to a 
request. 


DNS Retries 


Sets the number of times to query a name server. 


Default Domain Suffix 


Appends this field to Domain name service searches. 


X Environment menu 


Configuration menu for the X environment. 


Enable Access Control 


Specifies whether to allow all hosts to connect to the display or 
only hosts listed in the Display Access Table. 


Retain X Settings 


Controls whether settings are lost when server resets. 


Backing Store 


Specifies the degree of backing store. See Table 2-1 in Chapter 2. 


Default Visual 


Specifies type of color map, color index, or grayscale. 


Dual Display 


Specifies the position of dual displays. (Not available on NC200 
and NC900.) 


Host Connect Method 


Specifies the method of connecting to a host. 


Old DW Compatibility 


Enables the use of older DECwindows clients without display 
errors that may otherwise occur if you don't use this command. 


SME ResetServer 


Specifies whether the server is reset when the DEC Session 
Manager quits. Set this to Ignore if you use multiple Session 
Managers simultaneously. 


Font Cache Limit 


Specifies the amount of memory (in kilobytes) available to the font 
cache for saving font information currently used. 


Empty Font Cache 


Removes font information currently stored in the font cache. 


Root Depth 


Specifies the number of bit planes used for color (8 or 16). 


Peripheral Ports menu 


Configuration menu for the serial and parallel ports. 


Serial Port 0, Serial Port 1, 
Parallel Port 


Configures the serial ports for data bits, stop bits, parity, flow con- 
trol, and baud rate to match the device connected to the port. 


Network-to-Port Process 


Enables or disables current port settings. To change a port's 
settings, select Disable then make the changes. To activate the new 
settings, select Enable. 


Network-to-Port Priority 


Specifies the rate for processing data to and from the port. If on a 
busy network, set the priority rate to Low. 
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Table 3-8 Configuration Summaries Menu Items (continued) 
Menu Item and Options Description 



Socket Number 



Specifies the socket number to use for the port. Available sockets 
are: 87, 88 (Serial ports), and 89 (Parallel port) for TCP/IP 
networks; and 128, 129 (Serial ports), and 130 (Parallel port) for 
TDEnet networks. 



Network Protocol 
Connections Allowed 

Port in Use 



Specifies the network protocol: TCP/IP or TDEnet. 

Specifies the number of connections that can be in process (or 
spooled) for a single port. Maximum is 5. 

Specifies whether a port is in use and what is using it, for example, 
Session, Tablet, or Touchscreen. 



Host File Access menu 
Primary File Access 



Configuration menu for host file access. 

Specifies primary method of finding configuration/font files. 



Primary File Host 



Specifies host or NFS mount point to obtain configuration/font 
files. 



Primary XP File Root 
Secondary File Access 



Specifies path to root of site configuration file tree. 

Specifies the secondary method of finding the configuration/font 
files. 



TDEnet menu 



Configuration menu for TDEnet. 



TDEnet NC Name 
TDEnet Address 



Name used by clients to identify the network computer. 
Specifies address of the network computer on the network. 



Protocol State 



Specifies whether the TDEnet protocol is currently active, or shut 
down. If shutdown, Active attempts to restart the TDEnet protocol. 



Default Cterm Host 
Enable Trigger Reboot 



Specifies Cterm host name. 

Enables the DECnet TRIGGER command to reboot the network 
computer. 



Trigger Password 



Specifies the TRIGGER command's password. 



Connect (seconds) 
Hello (seconds) 



Specifies the interval between TDEnet connection attempts. 
Specifies the interval between hello packets. 



Inactivity (seconds) 



Specifies inactivity time before keepalive packets are sent. 
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Table 3-8 Configuration Summaries Menu Items (continued) 


Menu Item and Options 


Description 


TDEnet menu (continued) 


Configuration menu for TDEnet. 


MOP Identify (seconds) 


Specifies the interval between MOP identification packets. 


Retransmit Limit 


Specifies the number of times a packet requiring acknowledgment 
is transmitted on an established connection before timing out. 


Input Extension menu 

Select Core Pointer Device 


Configuration menu for alternative input devices. 
Specifies the input devices (can specify up to three devices). 


Device on Serial Port or 1 


Selects the device description file for the attached device. 


Calibrate TouchScreen 


Invokes the TouchScreen calibration procedure. 


Lower Left Device X,Y 


Specifies the X,Y calibration point for TouchScreen and Tablet. 


Upper Right Device X,Y 


Specifies the X, Y calibration point for TouchScreen and Tablet. 


Calibrate Tablet 


Invokes the Tablet calibration procedure. 


Adjust TouchScreen 
Button-Down Threshold 


Specifies the TouchScreen button-down threshold. 


Adjust TouchScreen 
Button-Up Threshold 


Specifies the TouchScreen button-up threshold. 


LAT menu 


Configuration menu for LAT. 


Service Directory Size 


Specifies maximum number of services allowed in the services 
database of the network computer. 


Protocol State 


Specifies whether the LAT protocol is currently active, or shut 
down. If shutdown, Active attempts to restart the LAT protocol. 


Circuit Timer 


Specifies interval between messages sent from network computer 
to host. 


Connect Timer 


Specifies waiting time for a service connection to be accepted. 


Keepalive Timer 


Specifies interval between keepalive messages. 


Retransmit Timer 


Specifies interval between retransmissions attempts. 


Retransmission Limit 


Specifies number of times the network computer retransmits a 
message before giving up. 


CSLIP Configuration menu 


Configures the network computer for use with CSLIP. 


CSLIP 


Enables or disables the CSLIP feature. Acts as a toggle. 


Serial Port 


Specifies on which port to start the CSLIP session. 
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Table 3-8 Configuration Summaries Menu Items (continued) 
Menu Item and Options Description 



Add Default Route 



Specifies whether the destination IP address is added as the 
gateway default in the gateway table. 



Compression 

Destination IP Addr 
Source IP Addr 



Specifies whether compression is enabled or disabled while 
sending and receiving data. Select Allow if you want compression 
to be available only if needed. 

Specifies the address of the host to which you are connecting. 
Enter the host name or address in decimal dot format. 

Specifies the network computer's IP address. IP addresses can be 
assigned dynamically by the host when dialing into a modem pool. 
To have the address assigned, leave this field blank. 



MTU 

Subnet Mask 
Protocol State 



Connection Method 



Specifies the maximum transmission unit for data transmission. 
This value must match the server's MTU value. 

Specifies the subnet mask used for the CSLIP session. 

Starts a CSLIP session on the network computer. 



Update Protocol State 


Activates and stops the CSLIP session. Acts as a toggle. 


PPP/Session Manager 


Configures the NC for serial communications via Point-to-Point 
Protocol. 


Session 


Specifies the session number. Valid values are 1-8. 


Session Name 


Assigns a name to each numbered session. 


User Name 


This is the character string that represents the user ID. 


Password 


This character string specifies the password for the associated user 
ID. 


Local IP 


Specifies the IP address of the local terminal. Generally, it is best 
to leave this entry blank, as it is usually assigned automatically. 



Specifies the connection method to use with PPP Choices are dial 
out (for use with modem), script (lets you customize the log-in 
with usernames, passwords and expected prompts to fit your spe- 
cific host), manual (handle log-in process manually), and direct 
(direct cable connection). 



Port 



Specifies the serial port used. Choices are SpO, Spl, or Ethernet. 



Phone # 



Specifies the telephone number dialed to access the host. 



Connect String 



Specifies the string used to make a connection. 
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Table 3-8 Configuration Summaries Menu Items (continued) 



Menu Item and Options 


Description 


Disconnect String 


Specifies the string used to terminate a connection. 


Connection Type 


Specifies the type of session to initiate upon completed connec- 
tion. 


Connect 


Initiates the connection process. 


Save Settings to File 


Configuration menu for Save Settings to File. 


Save Settings File Host 


Specifies the host name or address on which the configuration file 
is written. 


Save Settings Access Method 


Specifies the access method to the host. 


Save Settings File Name 


Full pathname to the configuration file. If using TFTP, this file 
must be created before performing a Save Settings to File. 


Save Settings to File 


Saves and writes the current Setup configuration to the specified 
file on the specified host. 
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Network Tables and Utilities Menu 

Note: If a Token-Ring interface is present, the selections for TDEnet 
and LATdo not appear. 

This is where you access menus for network tables and utilities, including 
Network Utilities, Gateway Table, NFS Mount Table, Internet Host Table, 
Display Access Table, Font Directory Table, TDEnet Host Table, LAT Group 
Codes Table, Console, and Script Parameters. 
Table 3-9 Network Tables and Utilities Menu Items 



Menu Item and Options 


Description 


Network Utilities 


Accesses the ping utility. 


Host Name/Host Address 


Specifies the name or address of the host to ping 
(TCP/IP) or Mirror Loopback (TDEnet). 


Timeout (Sees) 


Factory setting is 20 seconds (Ping Only). 


Test Packet Length 


Specifies the test packet length. 


Test Packets to Send 


Specifies the number of times test packets are sent. 


Test Packet Data 


Specifies the packet data. 


Test 


Sends a ping or mirror test packet to the specified host. 


Gateway table 


Examine/add/delete gateway hosts. 


Network Number 


Specifies network number portion of the network IP 
address of the host to be reached. Entering the word 
Default tells the network computer to use the default 
network number of 0.0.0.0. If you enter 0.0.0.0, the 
word Default displays as the network number. 


Gateway Number 


Specifies the IP address of one or more routers. 


NFS Mount table 1 


Examine/add/delete NFS mount points. 


File System Name 
Local Directory 
Transfer Size 


Specifies the name of the remote file system and local 
directory to be mounted. Specifies the transfer read 
size for each mount. 


Internet Host table 


Examine/add/delete IP hosts. 


IP Address 


Specifies address of an Internet host. 


Boot Host Name 


Specifies the Internet boot host name. If xp_boothost 
displays, see the Internet Host Table for its address. 
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Table 3-9 Network Tables and Utilities Menu Items (continued) 



Menu Item and Options 



Display Access table 
Host Address 



Font Directory table 



Font Directories 



TDEnet Host table 1 
TDEnet Address 



Boot Host Name 



LAT Group Codes table 
Group Codes 



Console 



Script Parameters menu 



Parameter 



Value 



Description 



Examine/add/delete display access hosts. 

Specifies decimal-dot address or host name of Internet 
host, or TDEnet address or node name followed by a 
colon ( : ). 



Examine/add/delete font hosts/paths. 



Specifies path names for font directories on the 
primary or secondary font host. When adding or 
deleting entries to the font directory table, it can take a 
few seconds to read the fonts, dir and fonts, tbl files. 



Examine/add/delete TDEnet hosts. 

Specifies the decimal-dot address of the TDEnet host. 



Specifies the TDEnet boot host name. When adding 
host names, the name appears exactly as typed. When 
deleting hosts, names are not case-sensitive. 



Examine/add/delete LAT group codes. 

Specifies the codes used to partition a single network 
into smaller networks. 



Opens the Console window. This option is the only 
way to open a remote Console window when the Setup 
menu has been displayed on a remote X device. 



Examine/add/delete script parameters. 



Specifies the parameter used in a script to automate a 
task. 

Specifies the value used for the parameter when it is 
encountered in the script. 



To differentiate where table entries are stored, entries in the Gateway, NFS 
Mount, Internet Host, Display Access, and TDEnet Host tables are labeled 
as NV if they are stored in NVRAM. Entries stored in RAM (in a .tbl table) 
are not labeled. NFS mounts that fail are labeled NVFAIL. 

The Add Table Entry button adds an entry to NVRAM, or moves an 
existing RAM entry into NVRAM. (To add a table entry in RAM, make the 
entry in the appropriate .tbl file.) The Delete Table Entry button deletes 
NVRAM and RAM entries, and failed NFS mounts. 
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Statistics Menu 



Note: Ethernet statistics appear for Ethernet LAN networks. If a 

Token-Ring network is being used, Token-Ring statistics appear. 
Token-Ring does not currently support TDEnet, therefore, 
TDEnet statistics do not appear. 

Use the Statistics menu to access menus that display statistics for Memory, 
Network, TCP/IP, Options, and TDEnet. 

Table 3-10 Statistics Menu Items 

Menu Item and Options Description 

Memory statistics: (Kbytes) Displays memory statistics 

Total Memory 
Free Memory 
Largest Block Free Memory 

Network statistics: Displays Network statistics 

Received Frames OK 
Broadcast Frames Received OK 
Multicast Frames Received OK 
Frame Check Sequence Errors 
Alignment Errors 
Fragments 

Internal MAC Rev Errors 
Frames Transmitted OK 
Single Collision Frames 
Multiple Collision Frames 
Total Collision Frames 
Late Collisions 

Deferred Transmission Frames 
Excessive Collisions 
Excessive Deferrals 
Lost Carrier Sense 
Internal MAC Xmit Errors 
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Table 3-10 Statistics Menu Items (continued) 



Menu Item and Options 


Description 


Token-Ring statistics: 


Displays Token-Ring statistics. If a 


Frames Received OK 


Token-Ring network is not being 


Broadcast Frames Received OK 


used, this option is not available. 


Frames Transmitted OK 




Line Errors 




Burst Errors 




ARI / FCI Errors 




Abort Transfer Errors 




Lost Frame Errors 




Receive Congestion Errors 




Frame Copied Errors 




Token Errors 




Internal Errors 




Last Ring Status 




Upstream Neighbor 




Soft Errors 




Hard Errors 




Signal Loss Errors 




Transmit Beacons 




Recoveries 




Lobe Wire Faults 




Removals 




Single Station 




Frequency Errors 
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Table 3-10 Statistics Menu Items (continued) 



Menu Item and Options 



Description 



TCP/IP Statistics: 

IP Statistics: 

Total Packets Received 
Bad Checksums 
Fragments Received 
Fragments Dropped 
Fragments Timed Out 

ICMP Statistics: 
ICMP Errors 
Bad Checksums 

UDP Statistics: 
Packets Dropped 
Bad Checksums 
Bad Length 

TCP Statistics: 

Transmitted Packets 
Received Packets 
Retransmitted Packets 
ACK Packets Received 
Connections Initiated 
Connections Accepted 
Connections Established 
Connections Dropped 



Displays TCP/IP statistics. 



Options: 

Authorization Key 
Option List 

TDEnet statistics: 

Total Blocks Output 
Total Blocks Input 
Total Bytes Output 
Total Bytes Input 
Hello Messages Sent 
Hello Messages Received 
Circuit Down Count 
Ethernet Input Errors 
Ethernet Output Errors 



Displays the authorization key and 
authorized options. 



Displays TDEnet statistics. If 
TDEnet is not enabled, this option is 
grayed out and cannot be selected. 
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Chapter 

Boot Monitor 
Overview 



The Boot Monitor is a command-line utility that provides an easy way to input 
boot commands. Using the Boot Monitor, you can access the Extended Self-Test 
menu and set parameters describing the network computer in your network 
environment. Some of the primary parameters are: 

• Addresses for the network computer, host, and gateway. 

• The location of the X server software. 

• How the network computer is booted (downloaded and started). 

• Keyboard type and nationality. 

When the Boot Monitor is running and awaiting a command, the BOOT> 
prompt is displayed on the screen. Each command-line (i.e., command plus 
associated parameters) is echoed on the screen as typed and must be terminated 
with the Return key. Boot Monitor commands are not case sensitive, however, 
arguments to the commands can be case sensitive. 

Once the necessary configuration parameters are entered correctly and saved, or 
if the host remote configuration file is complete and accessible, going to the 
Boot Monitor is not necessary. When the network computer is powered on, the 
network computer Operating System (or Extended Self- Test) is automatically 
booted. 



NCBridge Reference Manual 4-1 



53 



Chapter 4 Boot Monitor 



Accessing the Boot Monitor 



Normally, the Boot Monitor is activated only if an abnormal condition prevents 
the network computer from booting and running in normal network computer 
(or Extended Self-Test) operating mode. These following conditions 
automatically access the boot monitor: 

The Kernel Self-Test detected a hardware fault. 

Nonvolatile memory checksum is bad. 

Boot information does not exist in nonvolatile memory and RARP, BOOTP 
or MOP broadcasts failed after a 20 second broadcast period. 

The boot host is not accessible. 

The boot directory does not exist. 

Boot image files do not exist or are not usable (the file permissions may be 
set incorrectly or the files corrupted). 

The boot process was interrupted with a keystroke. 

The Boot Monitor displays the reason the boot failed, and provides an interface 
to enter boot parameters. Pressing h (for help) at the BOOT> prompt lists the 
available commands. 



Boot Monitor Commands 

Table 4-1 on page 4-3 lists the Boot Monitor commands. Detailed command 
descriptions follow. You can abbreviate the commands to the minimum number 
of letters specified in bold in Table 4-1. 
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Table 4-1 Boot Monitor Commands 
Use This Command: To: 



Authorize authorization-key 



Enable optional software. 



BAfrom BootP or DHCP or ARP Specify where to get boot addresses. 



BDelay DISABLED or RANDOM 
or n 

BMethod ROM or MOP or TFTP 
or NFS [Read size] 



Disable or set a boot delay time. 



Specify the boot method for loading the system files. 
The read size specified for NFS is used for all NFS file 
access as well. 



Boot [ROM or MOP or TFTP or 
NFS] [boot_path] 



Load the system files and start the network computer. 



BPath path_and_filename 
Dnode decnet_address 



Specify the full path and filename to the system files. 
Specify the DECnet node address. 



ERase 

ETherstat 



Clear the screen. 

Print Ethernet statistics (Series NC200, NC400, and 
XP330). 



Help or ? 



Show Boot Monitor command summary or detail. 



IAddr ip_address 
IEee yes or no 



Specify the network computer address. 

Enable or disable IEEE 802.2/803.3 framing. This 
command does not appear as part of the Help command 
listing on XP10 network computers. 



IGate ip_address 
IHost ip_address 
IMask ip _subnet_mask 



Specify the gateway address. 
Specify the boot host address. 
Specify the network subnet mask. 



Keyid nation layout d 
KFile filename 



Specify the keyboard type and layout. 
Specify the custom keyboard file. 
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Table 4-1 Boot Monitor Commands (continued) 



Use This Command: 


To: 


LANif AUTO or DUP m or RATE 

n 


Specify special LAN modes, AUTOnegotiation 
(default), DUPlex m (m=HALF or FULL mode), or 
RATE n (n=10 or 100 Mbps rate). 


LAnspeed 4 or 16 


Specify the Token-Ring interface bit rate (4 Mbps or 
16Mbps). 


LOcaladdr xx:xx:xx:xx:xx:xx 


Specify a locally-administered address. 


Mtu <number> 


Sets a maximum length of the information field of the 
frame. 


NAME <client_name> 


Specify a unique name for the network computer at the 
Boot Monitor level prior to network computer boot. 


NAtion type 


Specify the nationality of your keyboard. 


NVFactory 


Restores NVRAM to factory defaults. 


NVLoad 


Load parameters from NVRAM. 


NVSave 


Save parameters to NVRAM. 


Ping host_ip_addr timeout 


Verify the network connection between two IP 
addresses. 


REport 


Display the network computer's hardware configura- 
tion. 


RESET 


Reset the network computer. 


SElftest 


Access Self- Test. 


SE MONSET 


Displays the types of monitors the network computer 
can support. 


TOkenstat 


Prints Token-Ring statistics. 
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Authorize Command 

authorize authorization-key 

The authorize command displays the authorization key or enables the option(s) 
specified by the entered authorization key. 

The authorization key consists of 17 alphanumeric characters, including 
punctuation marks. The authorization key is printed on the Serial Number label. 
When entered, it enables one or more software options, such as TDEnet or XIE, 
to run on the network computer. 

When adding options, you must assign a new authorization key. This allows the 
new options to run in addition to the existing options. When entering a new 
authorization key, you may be notified that the new key has disabled one or 
more options. In this case, this warning message is displayed: 

WARNING: previously enabled option (s) have been disabled 

Previous and new authorization keys are also displayed, as well as the previous 
and new option masks (hexadecimal representations of enabled options). 

The authorization key is stored in NVRAM and should not be changed unless a 
new option requiring a new authorization key is added, or a related hardware 
failure occurs. The Save Current Settings and Clear Settings selections on the 
Setup Main Menu do not affect the authorization key. 

Parameters 

authorization-key specifies the 17-character authorization key. 

Examples 

boot> a 

Currently: 4X3 . b . SSnW47c ( -b ( 
Displays the authorization key. 

boot> authorize 4X3.b.SSnW47c9-b( 
Sets the authorization key to 4X3.b.SSnW47c9-b( 
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Authorization Key Manager 

The Authorization Key Manager client is available for setting the authorization 
keys for several network computers at once. For details about the client, refer 
to the Authorization Key Manager topic in your NCD NCBridge Installation 
and Configuration manual. 

BAfrom (Get Boot Address From) Command 

The BA from command tells the network computer whether to get its boot 
address and other boot information from NVRAM or from the network via a 
broadcast protocol such as BOOTP or RARP. In previous releases, choosing 
NE twork sets the network computer broadcast for this critical booting 
information in a default sequence: First it tried DHCP, then BOOTP, then 
RARP. Whichever method yielded a server response first was the protocol that 
would be used to deliver the information. Some customers, however, may wish 
to restrict network address resolution to a specific protocol. Boot ROM version 
7.4 allows you to restrict the broadcast protocol used for network boot address 
information to either DHCP, BOOTP, or RARP. Table 4-2 shows BAfrom 
command- values and what each one does. 

Table 4-2 BAfrom Command Descriptions 



Command syntax 


Explanation 


BA NVRAM 


Get boot address from the network computer's NVRAM. 


BA DHCP 


Get boot address from the network using DHCP only. 


BA BOOTP 


Get boot address from the network using BOOTP only. 


BA RARP 


Get boot address from the network using RARP only. 


BA NEtwork 


Get boot address from the network using all available methods in 

this order: 

DHCP 

BOOTP 

RARP 
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The ability to specify broadcast protocol is an advantage for system 
administrators because it eliminates the need for them to manually create and 
maintain tables with network computer names and Ethernet addresses on their 
DHCP servers. By specifying DHCP as the BA from method, you can let your 
network computers pass their names to the DHCP server — which issues them 
IP addresses — without worrying about matching device names with Ethernet 
addresses. 

Note: This feature ONLY works if the BAf rom command is set to 
DHCP. 



These settings persist through an NVFactory (default reset) after an NVSave. 

BDelay Command 

bdelay DISABLED or RANDOM or n 

The bdelay command specifies if there is a delay before booting the network 
computer after a reset or power cycle. The delay can be random (1 to 63 
seconds, generated from ethernet address) or a specified number of seconds. 
This feature is useful when many network computers may be trying to boot at 
once. 



Parameters 
DISABLED 
RANDOM 



Examples 



BOOT> 
BOOT> 



specifies that the network computer does not wait (default). 

specifies the network computer waits a random time (under 63 
seconds) before trying to boot. The boot delay time is generated 
based on the last two digits in the hardware address (not to 
exceed 63 seconds). 

specifies that the network computer waits a specified number of 
seconds before trying to boot. (Range 1 to 3600 seconds) 



bdd 
bd30 
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BMethod Command 

bmethod ROM or MOP or TFTP or NFS [Read size] 

The bmethod command specifies how the network computer locates and 
downloads the system files. 

Parameters 

ROM specifies that the network computer boots from the physically 
installed ROMs 

MOP specifies that the network computer boots across a TDEnet network 

TFTP specifies that the network computer boots across a TCP/IP network 

NFS [Read size] specifies that the network computer boots via NFS with a 
specified read size (1024 to 8192) 

Examples 

BOOT> bm r 

BOOT> bm m 

BOOT> bm t 

boot> bm n 8192 
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Boot Command 

boot ROM or MOP or TFTP or NFS 

The boot command downloads the network computer operating system using 
the method specified by the BMethod command, or one of the boot parameters. 
New boot parameters are active as long as the network computer is powered on. 
Use NVSave to retain parameters after the power is turned off. If the network 
computer cannot boot, the Boot Monitor is displayed. 

Parameters 

ROM boots from the physically installed Flash memory or ROM 

MOP boots across a TDEnet network 

TFTP boots across a TCP/IP network 

NFS boots via NFS 

boot_path specifies the boot path to use (optional) 

Examples 

BOOT> b 
BOOT> b t 

BPath Command 

bpath path and filename 

The bpath command specifies the full path and filename where the boot file 
resides on the host. 

Parameter 

path specifies the path where the boot file resides 

Examples 

boot> bp /tekxp/boot/config/os.900 
boot> bp TEK$NC900_BOOT:NC900_OS 
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CLient_id Command 

client_id ON or OFF 

The client_id command specifies whether or not the client identifier field is 
used during the DHCP boot process. 

Parameter 

ON enables the use of the DHCP client ID field in DHCP packets the boot 

ROM sends. This is the default setting. 

OFF disables the use of the DHCP client ID field. 

Examples 

boot> client_id OFF 

Dnode Command 

dnode decnet_address 

The dnode command specifies the DECnet node address of the network 
computer. It is only used if the TDEnet option is available. 

Parameter 

decnet_address specifies the DECnet address. 
Example 

boot> d 11.20 

Erase Command 

erase 

The erase command clears the display screen. 

Example 

boot> er 
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Etherstat Command 

etherstat 



The etherstat command prints a list of the ethernet commands. This command 
is for Series 330 network computers only. 

Example 

boot> et 



Help Command 

help 

The help command lists the available Boot Monitor commands along with a 
brief description of each. Typing a question mark (?) is the same as typing help. 

Examples 

BOOT> h 
BOOT> ? 

lAddr Command 

iaddr ip_address 

The iaddr command specifies the internet address for the network computer. 

Parameter 

ip_address specifies the IP address for the network computer. 

Example 

boot> ia 128.07.60.30 
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IEEE Command 



ieee yes or no 



The IEEE command enables or disables the IEEE 802.2/803.3 framing. The 
default setting is no, which means the network computer uses the traditional 
DIX Ethernet framing. Use the NVSAVE command to save the IEEE setting in 
memory. 

Example 

boot> ie y 

IGate Command 

igate ip_address 

The igate command specifies the internet address for the gateway. A gateway 
is required if the network computer address and the host address belong to 
different networks. 

Parameter 

ip_address specifies the IP address for the gateway. 
Example 

boot> ig 128.07.60.255 

IHost Command 

ihost ip_address 

The ihost command specifies the internet address for the boot host when 
booting with tftp. 

Parameter 

ip_address specifies the IP address for the boot host. 
Example 

boot> ih 128.07.60.01 
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IMask Command 

imask ip_subnet_mask 

The imask command specifies the internet protocol subnet mask to be used for 
network communications. The mask must be specified before gateway 
communications can occur. 

Parameter 

ip_subnet_mask specifies the network subnet mask. 
Example 

boot> im 255.255.255.0 

Keyid Command 

keyid nation layout (d or I) 

The keyid command brings up a menu that displays the keyboard identifier. 
This tells the network computer the layout and nationality (North American, 
German, Swedish, etc.) of the connected keyboard. 

Press the spacebar and use the arrow keys to move the highlight across the 
layout selections. Once the desired setting is highlighted, press the RETURN 
key. Next, highlight the desired language and press the RETURN key. Finally, 
select the desired DEC data processing mode and the LK401 option. Some 
layout and nationality combinations are not allowed, and cannot be selected. 

The Follows Language setting tells the keyboard to get the keyboard nationality 
setting from the NAtion command. Table 4-3 on page 4-14 shows the available 
keyboard layouts and nationalities. If this setting is used, the keyboard 
nationality reflects any NAtion changes, while retaining the current layouts and 
modes. The Follows Language setting is the default. 

Note: The keyboard identifier is automatically saved into NVRAM. The 
value is not affected by the NVSave, NVLoad, or SElftest 
commands. 
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Table 4-3 Keyboard Layout and Nationality 



Layout 


Nationality 


101/102 with Setup key 


North American 


101/102 with Pause key 


United Kingdom 


VT200/LK401 ULTRIX (ESC) 


French 


VT200/LK401 VMS (Fll) 


Swedish 


VT200/LK401 X (ESC-BS-LF) 


Danish 


VT200/LK401 X (F11-F13) 


Norwegian 


UNIX (North American only) 


German 


3270 


Italian 


SunV 


Spanish 


Custom (North American only 


Swiss/German 




Katakana 




Finnish 




Follows Language (keyid only) 



Parameters 

nation specifies the keyboard nationality. 

layout specifies the keyboard layout. 

d specifies the DEC data processing mode. 

1 specifies the LK401 keyboard when used with a VT200 Layout Code. 

Examples 



boot> k a 4 d 
boot> k b 2 
boot> k a 5 1 
Currently: a 



1 (North American 101) 
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KFile Command 

kfile filename 

The kfile command specifies the custom keyboard file used with custom 
keyboards. 

Parameter 

filename specifies the custom keyboard file. The file must be located in the 
boot directory. 

Example 

BOOT> KFmyfile 

LAN if Command 

The LANif command allows the user to specify the LAN transmission 
mode/rate. AUTO negotiation is the default, but users can also select DUP lex 
m RATE n, where: 

• m specifies mode of transmission ( HALF or FULL duplex). 

• n specifies rate of ethernet transmission (10Mbps or 100 Mbps) OR 
n specifies the Token Ring rate of transmission (4Mbps or 16Mbps). 

Example 4-1 LANif Examples for Ethernet 

Ian auto 

Ian dup full 10 

Ian dup half 10 
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LANSpeed Command 

lanspeed rate 

The lanspeed command specifies the Token-Ring interface bit rate. 

Parameter 

rate specifies either 4 Mbs or 16 Mbs. If a rate is not specified, default is 

16 Mbs. 

Example 

boot> lans 16 

LOcaladdr Command 

localaddr address 

The localaddr command specifies the locally-administered address (LAA) for 
the network computer booting on a Token-Ring network. This command is 
optional. 

Parameter 

address specifies the locally-administered address. 

Example 

BOOT> lo 40:01:02:03:04:05 
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Mtu Command 

mtu number 



The mtu command sets the Maximum Transmission Unit (MTU) as the Token- 
Ring interface to the network computer. The MTU may be set before the first 
boot. If this command is not used, the preset MTU default setting is used. 

Note: If MTU is set above 2052, large amounts of memory are reserved 
for network buffers at boot time. This memory usage is not 
evident until the next time you reboot the network computer. 

Parameter 

number specifies a number that corresponds to the maximum length of the 
information field of the frame. 

Valid numbers are: 

516 

1500 (factory default) 

2052 

4472 

8144 

11407 

17800 

Example 

boot> m 1500 
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NAME Command 

name <client name> 



The new NAME command in Boot ROM version 7.3 (or higher) allows users 
to identify each network computer with a unique name at the Boot Monitor 
level, before the network computer is booted. We now send the network 
computer's name to the DHCP server if the name has been set and BA from is 
set specifically to DHCP . If the network computer' s BA from value is 
NE twork and the first server that responds is a DHCP server, the name value 
is not transmitted. 

If you do not specify a value after the NAME command, it responds with the 
current name of the network computer. 

A network computer's name can also be set in Setup's Configuration 
Summaries I TCP/IP Configuration Menu in the top field; this too works 
with the BA from DHCP setting. But the new NAME command allows users 
to give their network computers names before booting. 

Parameter 

client_name specifies the name of the network computer used at Boot 
Monitor level. 
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NATion Command 

nation type 



The nation command specifies the language used for prompts and text within 
X clients that can adapt to language settings. Table 4-4 lists nationality types 
and their associated letters. 

Table 4-4 Nation Settings 



Letter Designation 


Nation 


a 


United Kingdom 


b 


French 


c 


Swedish 


d 


Danish 


e 


Norwegian 


f 


German 


g 


Italian 


h 


Spanish 


i 


Swiss/German 


J 


Katakana 


k 


Finnish 



Parameter 

type specifies the letter code for the nationality. 
Examples 

boot> na b 

boot> na 

Currently : b (United Kingdom) 
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NVFactory Command 

nvfactory 

The nvfactory command restores NVRAM to the factory defaults. 

Example 

BOOT> nvf 

NVLoad Command 

nvload 

The nvload command loads the parameters and settings stored in NVRAM. 

Example 

BOOT> nvl 

NVSave Command 

nvsave 

The nvsave command saves the current parameters and settings to NVRAM. 

Example 

boot> nvs 
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Ping Command 

ping ip_address timeout 

The ping command determines if a specified ip_address is responding to 
TCP/IP protocol network commands. A packet is sent to ip_address. If there is 
a reply, ping displays reply received and sends the next packet. If there is no 
reply within the timeout period, ping displays the message no reply and sends 
the next packet. Press Space to exit the ping command. 

Note: A device must be booted before it can respond to a ping request. 

Parameter 

ip_address specifies the IP address. 

timeout specifies the timeout period (default is 20 seconds). 

Examples 

boot> p 128.07.60.10 
BOOT> p 128.07.60.20 15 

RESET Command 

reset 

The reset command is used to reset the network computer to its power-on state. 

Example 

boot> reset 
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Report Command 

report 



The report command displays the network computer's hardware configuration. 
For Boot ROM version 3.0 or higher, the Ian: configuration displays one of 
these configurations, depending on the network computer model and LAN 
interface installed: 

XP330 Series: 

type 1 thick/lObaset backplane installed 
type 3 thick/thin backplane installed 

XP100, XP200, XP350, XP400, NC200, NC400, NC900: 

type AUI live network cable attached to the thicknet port 

type Thinnet live network cable attached to the thinnet port 
type 10BASE-T live network cable attached to the lOBaset port 

Example 



boot> re 

model : 
std mem: 
opt mem: 
vid mem: 
flash mem 
mon type : 
key type : 
nation : 
Ian : 
cpu id: 
cpu elk: 
options : 
serial : 
auth key 
opt mask 
autoboot 

SEIftest Command 

selftest monset 



N932 

16384K 

16384K 

4096K 

16384K 

121 (1024 x 768 70 Hz 17" Color) 

North American 101/102 with PAUSE key 

a (North American) 

AM79C71 Ethernet half-duplex, 100Mbps 

b33 

16 5Mhz 

parallel 

2 

3;Kj9/ .+Xk-<ptH5R 

00110000 

enabled 



When used as a stand-alone command, selftest accesses the local version of 
Self-Test. When used with the monset parameter, selftest sets monitor display 
configuration parameters for the network computer. 
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The monset parameter can be used with or without a numerical argument. 
Without an argument, the selftest monset command lists all monitor types 
consistent with the network computer's hardware configuration. Enter the 
appropriate monset number if you know it. If you do not know the correct 
monset number, enter selftest monset -1 and the network computer enters the 
scan mode. When in the scan mode, the screen display is black, and as you press 
the spacebar, the network computer advances through the list of monset values. 
When you select a monset that presents an acceptable display, press the Enter 
or Return key to store that selection in non- volatile memory. 

Example 

boot> se monset -1 

TOkenstat Command 

tokenstat 

The tokenstat command prints a list of the Token-Ring commands. 

Example 

BOOT> to 
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There are two types of self- tests: 

• Kernel Self-Test: A non-interactive test suite that performs the minimum 
hardware tests required to ensure booting. Kernel Self-Test resides in the 
boot ROM and executes automatically upon power-up. 

• Extended Self-Test: Menu-driven interactive and non-interactive tests 
intended for use by service personnel. Extended Self- Test is invoked from the 
boot monitor using the selftest command or downloaded from a remote host, 
depending on your network computer model. 
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Kernel Self-Test 



Kernel Self- Test runs automatically whenever the network computer is turned 
on and takes approximately 10 seconds to complete. If Kernel Self-Test runs 
without detecting a hardware fault, the network computer attempts to boot. 



Fault Information 

Self-test programs provide status and fault information by displaying codes 
with LED indicators on the keyboard, by ringing the bell, and by displaying 
messages on the display. In the event of a fault, if enough hardware is working, 
Kernel Self-Test continues to its completion, at which time the Boot Monitor 
takes control. The boot monitor continues to blink a fault code in the keyboard 
LEDS until the Return key is pressed. 

Table 5-2, Table 5-3, and Table 5-4 list the fault codes for FRU's tested by 
Kernel Self-Test. 

Keyboard LED Indicators 

The 101- and 102-key keyboards have three adjacent LED indicators in the top 
right corner. The VT200 keyboard has a fourth indicator (Hold Screen) to the 
left of the other indicators. Table 5- 1 on page 5-3 shows the indicator positions. 

Initially, keyboard firmware briefly turns the LEDs on, then off. Shortly after 
power-up, Kernel Self-Test sequences the LEDs, one at a time, from right to 
left. All LEDs are then turned on, and Kernel Self-Test tests the standard 
network computer memory. If no faults are detected, Kernel Self-Test 
initializes the network computer display and completes the kernel power-up 
testing. 

During the power-up sequence, Kernel Self-Test reports boot status to the 
keyboard LEDs. Table 5-1 lists the condition of the keyboard LEDs as Kernel 
Self-Test progresses through the boot process. 

For location of the indicators, refer to Appendix B, Keyboards for your specific 
keyboard. 
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Table 5-1 Boot Sequence LED Indicator Status Code Definitions 3 



Outer Left 
LED b 


Inner Left 
LED 


Inner Right 
LED 


Outer 
Right LED 


Meaning 


® 


® 


® 


® 


Kernel Self-Test Started 


X 


X 


X 


® 


Boot process begun 


X 


X 


X 


X 


Boot done (in boot monitor) 



a ® = on, x = off 

b VT200/LK401, UNIX, and Sun V keyboards only 

Pressing any key during Kernel Self-Test instructs the network computer to 
pass control to the boot monitor when Kernel Self-Test is complete and to 
display this message: 

Boot process interrupted by key press... 

Type HELP for a list of commands 

BOOT> 

Pressing any key during the boot process after Kernel Self- Test is complete 
instructs the logic module to terminate the boot and pass control to the boot 
monitor. This message appears on the display: 

Boot terminated due to key press 
Type HELP for a list of commands 
BOOT> 

Self-test programs reveal status and fault information by displaying failure 
codes with light-emitting diode (LED) indicators on the keyboard, by 
displaying fault messages on the display, and by ringing the bell. 
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Table 5-2 lists the faults for FRUs tested by Kernel Self-Test. 

Table 5-2 LED Indicator Fault Code Definitions for Series XP330 Network Computers 



Functional 
Blocks 


Hold 

Screen 

LED 


Left 

LED 


Middle 
LED 


Right 
LED 


Faulty FRU Indicated 


CPU 


X 


X 


X 


® 


Main logic board 


GPU 


X 


X 


® 


X 


Main logic board 


NVR 


X 


® 


® 


X 


Main logic board 


EXC 


X 


® 


® 


® 


Main logic board 


RAM 


X 


® 


X 


X 


Option Memory SIMM 


ROM 


X 


® 


X 


® 


Boot ROM SIMM board 


SYS 


X 


X 


® 


® 


System (non-specific) 
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Table 5-3 presents the LED Indicator Fault Code Definitions for the NC200 and 
models; Table 5-4 shows the definitions for NC900 models. 

Table 5-3 LED Indicator Fault Code Definitions for NC200 Network Computers 



Hold 
Screen LED 


Left LED 


Middle LED 


Right LED 


Faulty FRU Indicated 


X 


X 


X 


® 


Main logic board 


X 


X 


® 


X 


Boot ROM 


X 


X 


® 


® 


Option Memory DIMM1 


X 


® 


X 


X 


Option Memory DIMM2 


X 


® 


® 


X 


Flash Memory Option 


X 


® 


X 


® 


Keyboard/mouse interface 


X 


® 


® 


® 


Option I/O port 



® = blinking, X = off 

Table 5-4 LED Indicator Fault Code Definitions for NC900 Network Computers 



Hold 
Screen LED 


Left LED 


Middle LED 


Right LED 


Faulty FRU Indicated 


X 


X 


X 


® 


Main logic board 


X 


X 


® 


X 


Boot ROM 


X 


X 


® 


® 


Option Memory DIMM 


X 


® 


® 


X 


Flash Memory Option 


X 


® 


X 


® 


Keyboard/mouse interface 


X 


® 


® 


® 


Option I/O port 



If the display malfunctions, you can tell if the boot failed by noting the indicator 
display. If the bell rings, or both the middle and right indicators turn off 
together, or if any indicators are blinking, the logic module did not boot 
successfully and has entered the boot monitor. 

No activity on power-up indicates a malfunction in the kernel hardware (Boot 
ROM, CPU, ASICs, etc.). 
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Extended Self-Test 



The Extended Self- Test consists of a full complement of tests used by service 
technicians to diagnose hardware related problems. 
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SNMP is a protocol used by many network tools to manage devices that are 
networked together with TCP/IP. If your site runs an SNMP agent manager, you 
can set SNMP traps and community strings in the remote configuration file, and 
take advantage of the remote reboot variable in the mib. txt file. 

Note: The SNMP daemon (snmpd) is inactive while flashing the 
network computer (with the do_flash command). 

Supported Traps 

The supported traps are: 

• coldStart (1) the network computer issues this trap whenever the SNMP 
agent is started and the current time is sufficiently close to zero. 

• warmStart (2) the network computer issues this trap whenever the SNMP 
agent is started and the current time is sufficiently greater than zero. 

• authenticationFailure (16) signifies that the sending protocol entity is the 
addressee of a protocol message that is not properly authenticated. 

Configuration File Entry Examples 

In the following xp. cnf example, the first line directs that the warmStart and 
authenticationFailure traps (2+16=18) are sent to the host Oregon, using the 
community string public. The second line allows any host to use the community 
string public to browse (do GETs on) the network computer's management 
information base (MIB). The third line allows the host oregon to use the 
community string TekX to both GET and SET MIB variables. 

snmp_trap_list oregon public 18 
snmp_comm_list 0.0.0.0 public R 
snmp_comm_list oregon TekX RW 

Note: The available SNMP commands depend on the host client(s) used. 
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mib.txt File 

The mib.txt file (found in /tekxp/mgmt/mib.txt) contains MIB II and NCD MIB 
definitions. The NCD MIB portion of the mib.txt file includes network 
computer settings specified in Setup or in the xp.cn/file. These settings are not 
available in the MIB II portion of the file. The mib. txt file specifies system-level 
objects used by the network manager to identify the node being managed. The 
object system.sysDescr is a text string intended to be human-readable. When 
asked for the object, network computers respond with a string identifying the 
manufacturer, product nomenclature, and system version level. Here is an 
example: 

XP400 version 2 level 

System Object Identifier 

The system object identifier (sysObjectID) uniquely identifies the type of 
device being managed. Objects are named in the iso(l) org(3) dod(6) 
internet(l) private(4) enterprises(l) subtree. There is an object identifier for 
each network computer model. For a complete list of object identifiers, refer to 
the mib.txt file. 

An XP356 network computer would have a sysObjectID of: 

1.3.6.1.4. 1.128 .1.2.3 .356 
(iso.org.dod.internet.private.enterprises.tek.nwd.nwdproducts.xp.xp356) 

You can reboot any NCD network computer by using the reboot variable (1) 
and specifying the MIB file: 

1.3.6.1.4.1.128.1.1.3.1.1.0 i 1 
(iso.org.dod.internet.private.enterprises.tek.nwd.nwdmibs.xpmib.xpsys.xpreboot) 

mib.txt Network Computer-Specific Objects 

Table 6-1 lists network computer-specific objects that are included in the mib.txt 
file (located in /tekxp/mgmt/mib.txt). These can be set using SNMP. Many of 
these objects are also set through the remote configuration file (xp.cnf) or in Setup. 
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Where applicable, the equivalent remote configuration command is given. Refer 
to Chapter 2, Remote Configuration for details about the remote configuration file 
and commands. 

Table 6-1 Network Computer Objects in the mib.txt File 



mib.txt file object 


xp.cnf Command 
Equivalent 


Description 


xpreboot 




Reboots the network computer. 


xpSysServerReset 




Resets the server. 


xpSysNvSave 




Invokes NVSAVE. 


xpSysKeyboardNationality 


keyboard_language 


These objects specify keyboard settings. 


xpSysKeyboardLayout 


keyboard_type 




xpSysLanguage 


language 




xpSysScreenSaver 


screen_saver 


Invokes the screen saver. 


xpSysAuthorizationKeySet 




Specifies the authorization key. 


xpSysDefaultTelnetHost 


default_telnet_host 


Specifies the default Telnet host. 


xpSysOptionsMask 




Specifies options mask. 


xpSysSoftReboot 




Specifies a network computer reboot after 
the user logs out. This allows access to a 
new configuration after rebooting. 


xpSysLogHost 


loghost 


These objects specify the console log 


xpSysLogFacility 


logfacility 


messages. 


xpSysLogPriority 


logpriority 




xpSysEnableLogging 


enable_remote_logging 




xpSysConfigurationStatus 




Specifies whether the SNMP trap is read 
on subsequent network computer reboots. 


xpSysBootRom Version 




Displays the boot ROM version in use. 
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Table 6-1 Network Computer Objects in 


the 


mib.txt File (continued) 


mib.txt file object 


xp.cnf Command 
Equivalent 


Description 


xpMemStdRam 




These objects specify memory statistics. 


xpMemOptRam 




Partitions cannot be altered by the soft- 
ware. In Setup, the Memory option on the 


xpMemStdGraphicsRam 




Statistics menu displays memory infor- 


xpMemOptGraphicsRam 




mation as well. 


xpMemVideoRam 






xpMemAvailable 






xpMemLBlock 






xpDisVerticalResolution 




These objects specify the network com- 


xpDisHorizontalResolution 




puter type and configuration. 


xpDisVerticalSize 






xpDisHorizontalSize 






xpDisBitPlanes 






xpDisColor 






xpDisTypeCode 
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Table 6-1 Network Computer Objects in the mib.txt File (continued) 



mib.txt file object 


xp.cnf Command 
Equivalent 


Description 


xpMbufsTotalMbufs 




These objects specify amounts and usage 


xpMbufsFreeMbufs 




of the system network buffers. In Setup, 
the Network option on the Statistics menu 


xpMbufsTotalClusters 




displays network information as well. 


xpMbufsFreeClusters 






xpMbufsData 






xpMbufsHeader 






xpMbufsSocket 






xpMbufsPcb 






xpMbufsRtable 






xpMbufsSoname 






xpMbufsSoopts 






xpMbufsFtable 






xpMbufsRights 






xpMbufsIfaddr 






xpMbufsOther 






xpTftpReadRequests 




These objects specify tftp statistics. 


xpTftpWriteRequests 






xpTftpInDataPkts 






xpTftpOutDataPkts 






xpTftpInAckPkts 






xpTftpOutAckPkts 
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Table 6-1 Network Computer Objects in the mib.txt File (continued) 



mib.txt file object 


xp.cnf Command 
Equivalent 


Description 


xpTftpNoFileErrors 




These objects specify error message 


xpTftpTimeout 




handling. 


xpTftpRetries 






xpPrimaryBootMethod 


boot_method 


These objects specify boot parameters. 


xpPrimaryBootHostAddr 


boot_host_name 




xpPrimaryBootPath 


boot_path 




xpSecondaryBootMethod 


boot_method_2 




xpSecondaryBootHostAddr 


boot_host_name_2 


These objects specify the Domain Name 


xpSecondaryBootPath 


boot_path_2 


System for the network computer. 


xpB ootAddrFrom 


detennine_address_fro 
m 




xpBootDelay 


boot_delay 




xpBoot Verbose 


verbose_boot_msg 




xpBootlnterrupt 


enable_boot_interrupt 




xpBootConfig 


boot_config_type 




xpDnsEnable 


enable_name_service 




xpDnsDefaultDomain 


default_domain_suffix 




xpDnsTimeout 


dns_timeout 




xpDnsRetries 


dns_retries 




xpDnsNameServer 1 


name_server_l 




xpDnsNameServer2 


name_server_2 




xpDnsNameServer3 


name_server_3 
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Table 6-1 Network Computer Objects in the mib.txt File (continued) 



mib.txt file object 


xp.cnf Command 
Equivalent 


Description 


xpXAccessControl 


enable_access_control 


These objects specify X parameters. 


xpXAccessTable 


display _access_table 




xpXAccessEntry 


display_access_table 




xpXAccessEntryHost 


display _access_table 




xpXAccessEntry Enable 






xpXRetainSettings 


retain_x_settings 




xpXB acking S tore 


backing_store 




xpXDefault Visual 


default_visual 




xpXHostConnect 


host_connect_method 




xpXXdmcpConnect 


xdmcp_connect 




xpXXdmcp Table 






xpXXdmcpEntry 


xdmcp_menu_entry 




xpXXdmcpEntrylndex 






xpXXdmcp S erver 


xdmcp_server 




xpXOldDec Windows 


old_decwin_compatible 




xpXWinddServer 


default_windd_host 




xpSerialTable 




These objects specify serial port control. 


xpSerialEntry 






XpSerialEntry Index 






xp S erialEntry B aud 


baud_rate_0 




xpSerialEntryStopBits 


stop_bits_0 




xpSerialEntryDataBits 


data_bits_0 




xpSerialEntryParity 


parity_0 




xp S erialEntry FlowC ontrol 


flow_control_0 
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Table 6-1 Network Computer Objects in the mib.txt File (continued) 



mib.txt file object 


xp.cnf Command 
Equivalent 


Description 


xpSerialNetToSerial 




Serial port control (continued) 


xpSysEnableDisableNtoPort 


enable_net_to_port 
disable_net_to_port 




xpSerialNetToSerialPriority 


enable_net_to_port 




xpSerialNetToSerialProtocol 


net_to_port_protocol 




xpSerialNetToSerial- 
Connections 


net_to_port_connections 




xpSlipPort 






xpSlipComd 






xpSlipDestIP 






xpPrintTable 




These objects specify printer attributes. 


xpPrintEntry 






xpPrintEntry Index 






xpPrintEntryStatus 


enable_print_spooler 




xpPrintEntryAttribute 


spooler_local_queue 
spooler_remote_queue 


Local/remote print spooler queue 


xpPrintEntry Value 


spooler_local_queue 
spooler_remote_queue 


Queue name 


xpFilePrimaryAccess 


file_access_l 


These objects specify host file access 


xpFilePrimaryHost 


file_host_name_l 


control. 


xpFilePrimaryPathOrRoot 


file_path_l 




xpFileSecondaryAccess 


file_access_2 




xpFileSecondaryHost 


file_host_name_2 




xpFileSecondaryPathOrRoot 


file_path_2 




xpFontsTable 




These objects specify font accessibility. 


xpFontsEntry 






xpFontsEntry Index 






xpFontsEntry Path 
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Table 6-1 Network Computer Objects in the mib.txt File (continued) 



mib.txt file object 


xp.cnf Command 
Equivalent 


Description 


xpNfsTable 


nfs_table 


These objects specify NFS statistics and 


xpNfsEntry 


nfs_entry 


NFS mount table settings. 


xpNfsEntry Index 






xpNfsEntryLocalDir 


nfs_entry 




xpNfsEntryServerAddr 


nfs_entry 




xpNfsEntryServerDir 


nfs_entry 




xpNfsEntryReadSize 


nfs_entry 




xpNfsEntry WriteSize 


nfs_entry 




xpNfsEntryRetrans 






xpNfsEntry Timeout 






xpNfsNulls 






xpNfsGetAttributes 






xpNfsSetAttributes 






xpNfsGetRoots 






xpNfsLookups 






xpNfsReadLinks 






xpNfsReads 






xpNfsWriteCaches 






xpNfsWrites 






xpNfsCreates 






xpNfsRemoves 






xpNfsRenames 






xpNfsCreateLinks 






xpNfsCreateSymlinks 






xpNfsMakeDirs 
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Table 6-1 Network Computer Objects in the mib.txt File (continued) 


mib.txt file object 


xp.cnf Command 
Equivalent 


Description 


xpNfsRemoveDirs 




NFS statistics and NFS mount table 


xpNfsReadDirs 




settings (continued) 


xpNfsStatFileSys 
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Chapter 

Tek220 and Tek340 Emulators 



The Tek220 and Tek340 emulators can be opened through a Telnet, Cterm, 
Llogin, or Serial session. (The Tek340 emulator requires an authorization key.) 
The emulators are not linked directly to Telnet, Cterm, Llogin (i.e., LAT), or Tip 
and therefore download faster, require less memory, and can run multiple 
emulator sessions at once. 

The Tek220 and Tek340 emulators support color text as well as foreground and 
background color. You can apply a color to bold, blinking, selected, and 
reversed text. In the Tek340 emulator, using ReGIS graphics and the supplied 
setup screens, you can adjust the color of graphics by changing any of the 16 
color table entries. The Tek340 emulator also supports Tektronix 4010 and 4014 
vector graphics. 

This section presents the following information about the Tek220 and Tek340 
emulators: 

• How to start a Tek220 or Tek340 emulator. 

• How to use the emulators. 

• Available resources and command-line settings. 

• Keyboard translations. 

Note: The Tek340 emulator requires an authorization key. Refer to the 
Authorize command in Chapter 4, Boot Monitor. 
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Starting a Tek220 or Tek340 Emulator 

Tek220 and Tek340 sessions can be started several ways: 

• Type the xpsh command from your regular session window. These examples 
show how to open a Tek220 Telnet and Tek340 Cterm session: 

xpsh -display nc_address:0 tek220 -e telnet 
xpsh -display nc_address:0 tek340 -e cterm 

• Select a Tek220 or Tek340 session from the Client Launcher's Host 
Connection menu. 

• Use the remote configuration file's Start or Preload commands to automati- 
cally start an emulator session when the network computer boots. Refer to 
Chapter 2, Remote Configuration for information about these commands. 

• Use the HostMenu. 



Using Emulators 



When you start an emulator, the window displays as shown in Figure 7-1. 



Command Names 



Scroll Bar 



A- 



Tek2 2 



File Settings 



Figure 7-1 Sample Emulator Window 
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These elements are part of the emulator window: 

• Scroll Bars you use to scroll through the contents in the window. 

• Command Menus provide the available commands for changing window 
attributes. 

File Menu 

The File menu has four commands: Reset, Start Script, Abort Script and Quit. 

Reset Command 

This command resets the emulator window settings to the default settings. 

Start Script Command 

This command automatically loads and runs a script created in the scripting 
language. For details, refer to Executing a Script on page D-3. 

Note: To execute a script, it must be in the correct script directory. For 
UNIX, this is /tekxp/boot/conf ig/script. For NT and 
Windows 2000 hosts, it is \tekxp\boot\conf ig\script . The 
VMS location for the script is tek$xp_config : . The script 
name must appear in the script _files file in the same directory. 

Abort Script Command 

This command stops a script that is currently running. 

Quit Command 

The Quit command closes the emulator window and exits the session. 
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Settings Menu 

The Settings menu provides these commands: 

• Emulation 

• User Features 

• Resize 

• Color (for Tek340 emulators only) 

Emulation Command 

The Emulation command displays the Emulation dialog box containing the 
Emulation and DA Response fields. 

Emulation 

This field provides a way to start these additional emulator sessions: 
Table 7-1 Emulator Sessions 



Emulator Setting 


Description 


VT220, 8-bit 
VT340, 8-bit 


Starts a VT220 or a VT340 emulator that sends 8-bit control 
sequences. 


VT220, 7-bit 
VT340, 7-bit 


Starts a VT220 or VT340 emulator that sends 7-bit control sequences. 
This type of emulator can receive either 7- or 8-bit sequences. This is 
the default emulator. 


VT100 


Starts a VT100 emulator. This emulator does not accept VT200 or 
VT340 level escape sequences. 


VT52 


Starts a VT52 emulator. 


Tek40 10/40 14 


(Tek340 only) starts a Tek340 emulator that supports Tektronix 
4010/4014 vector graphics. 



DA Response 

The DA Response field is used to specify the emulator' s response to a device 
attribute request, also known as the terminal ID. This tells the host specific 
operating characteristics of the network computer. Specify one of these 
responses: VT340, VT240, VT220, VT102, VT101, or VT100. (Available 
options are different for the Tek220 and Tek340 emulators.) 
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User Features Command 

The User Features command displays the User Features dialog box containing 
the options shown in Table 7-2. 

Table 7-2 User Features 



Option 



Description 



Online Specifies whether the emulator accesses the host (On), or is local to the 

network computer (Off). Default is On. 

Specifies whether keyboard data is sent to the host only and the host 
sends the echoed characters (Off), or whether the keyboard data is sent 
to both the host and the local emulator (On). If turned on, double 
characters are echoed on your display. Default is Off. 

Specifies what characters are sent from keypad key presses. If turned 
off, the default keypad characters are sent. If turned on, application 
control sequences are sent. Default is Off. 

Specifies whether arrow keys send standard ANSI cursor control 
sequences (Off), or send application control sequences (On). Default is 
Off. 

Specifies if the scroll bar is present in the emulator window. Default is 
On. 

Specifies whether the emulator's default foreground and background 
displays in reverse video. This setting does not affect text with 
non-default colors. Default is Off. 

Specifies whether a new line is automatically started when text reaches 
the end of the column. If turned Off, the last character on a line is 
overwritten with the next character. If turned on, a new line is created. 
Default is On. 

Specifies what happens when the Enter key is pressed. If On, pressing 
Enter sends a carriage return and a line feed. If Off, pressing Enter sends 
a carriage return only and the cursor is not moved to a new line. Default 
is On. 

Specifies whether the host can change user features, such as tab settings. 
If On, the host cannot change user features; if Off, the host can change 
user features. Default is Off. 

Specifies whether the host can change user-defined keys. If On, the host 
cannot change user-defined key functions; if Off, the host can change 
user-defined keys. Default is Off. 



Local Echo 



Application Keypad 



Application Cursor Keys 



Scroll Bar 



Reverse Video 



Auto Wrap 



New Line 



Lock User Features 



Lock User Defined Keys 
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Resize Command 

The resize command allows you to select the number of rows and columns 
used. The default is 24 rows by 80 columns. 

Color Command 

The Color command (on color Tek340 terminals only) displays the Color 
dialog box. You can use the options in this box to adjust the 16 colors tables 
used in color text, and ReGIS graphics, and Sixel graphics. Tables through 7 
are used for color text; tables 8 through 15 are used for graphics. 

To adjust a color, pick the color table, and adjust the amount of red, green, and 
blue that displays. Click on the slider box and move horizontally to adjust the 
color. You can adjust as many of the color tables that are represented in the 
graphic or window. Click OK when finished. 
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Specifying Client Resource Settings 

Resource settings can be specified for Tek220 and Tek340 sessions. The 
resource settings can be set on the xpsh command-line, in the Client Launcher 
configuration file (system.launcher by default), or in one of the files listed 
below. The resource settings are read in the following order when started with 
xpsh, with the last file taking precedence over the first: 

For UNIX hosts: 

• XAPPLRESDIR/Tekterm (if the XAPPLRESDIR variable is defined) 
or Aekxp/boot/<language>/app-defaults/Tekterm. 

• X Resource Manager String property (defined using the xrdb command) or 
the $HOME/.Xdefaults file. 

• The file specified by the XENVIRONMENT environment variable 
or $HOME/.Xdefaults-<X_terminal_name>. 

For VMS hosts: 

• TEKTERM.DAT in XAPPLRESDIR (if XAPPLRESDIR is defined) 
orDECW$SYSTEM_DEFAULTS:TEKTERM.DAT. 

• [<Boot PathxAPP-DEFAULTSJTEKTERM.DAT. 

• TEKTERM.DAT in HOME (if HOME is defined). 

• Server defaults set up with xrdb or in an .Xdefaults file or 
DECW$XDEFAULTS.DAT in HOME (if HOME is defined). 

• XENVIRONMENT resource file (if defined) or 
TEKTERM-<host>.DAT in HOME (if HOME and the hostname are found). 

For Windows NT hosts: 

• C:XXAPPLRESDIR/Tekterm (if the XAPPLRESDIR variable is defined) 
or <Boot Pa.th>\tekxp\boot\<language>\app-defaults\Tekterm. 

• \%HOMEDRIVE%\%HOMEPATH%\.Xdefaults 

• \%HOMEDRIVE%\%HOMEPATH%\Tekterm 

Note: For Windows NT, use the xpsh access method: 

xpsh -access xpsh tek220 -e telnet 
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Specifying a Resource 

A resource definition is generally composed of three parts (not all are required): 

• Application name (tek220, tek340) followed by a period (.)• 

• The resource (such as background) followed by a colon (:). 

• The assigned value (such as light grey). 

Each resource is specified on a separate line. For in-depth information about X 
resources, refer to the X Window System documentation. 

For example, this X resource sets the default background color to light grey for 
all Tek220 and Tek340 windows: 

Tekterm*background: light grey 

This example sets the background color to blue for the Tek340 application only, 
overriding the previous example: 

tek340 .background: blue 

The resource attributes and command-line arguments listed in Table 7-3 can be 
set in one of the resource files or as part of the xpsh command-line. 

Table 7-3 Resource Settings 



Resource Name 



none 
foreground 



Command-Line 
Argument 



Specifies 



-xrm <resource string> A resource string to be used. 

-fg Foreground color of the client. Default is black. 



background 


-bg 


shareColors 


none 


needPlanes 


none 



Background color of the client. Default is white. 

Whether to allocate ReGIS colors exclusively to the 
emulator (True) or not (False). Default is False. 

Whether to try and allocate 4 planes in the color map 
to accurately emulate a VT340. Default is False. 



holdLED 



clearRoot Weave 



-holdLED <led> The LED to be used when the HoldScreen key is 

pressed. Allowable values are none, default or an LED 
number from 1-32. Default is none. 

none Whether to set the root window to black on startup. 

Default is False. 
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Table 7-3 Resource Settings (continued) 



Resource Name 


Command-Line 
Argument 


Specifies 


centerOnRoot 


none 


Whether to position the window in the center of the 
screen regardless of geometry option. Default is False. 


reverse ANSIColors 


none 


Whether to display ANSI colors normally or reverse- 
color. 


printOptions 


-printOptions <options> 


Specifies the options to be passed on to the "lpr" com- 
mand. 


saveColorsToRMS 


none 


Whether to save color resources to the server data base 
when set in the Color dialog. Default is False. 


doubleClick 


-de 


Whether to support double clicking to select a word. 
Default is False. 


scrollBar 


-sb or +sb 


Whether to display a scroll bar. Default is True (-sb) 


scrollBarOnRight 


-sr 


Whether to display the scroll bar on the right side of 
the window. Default is False. 


telnet, script 




Specifies the name of the script to start when invoked 
with a telnet session. 


tip. script 




Specifies the name of the script to start when invoked 
with a tip session. 


saveLines 


-si <number> 


Specifies the number of lines to save that have been 
scrolled off the top of the screen. 


service 


-services 
specifier 


(For LAT sessions) Specifies a particular service to 

use. Specifier can be: 

blank shows all services 

service name shows a particular service 

node=service-node-name shows all services 

advertised by a particular service-node 
service-name/node=service-node-name shows a 

particular service on a particular service-node 


permanent 


-P 


(For LAT sessions) Permanent specifies that the LAT 
session connects to and re-connects to a particular 
service even after logging off. 


cursorColor 


-cr 


Color of cursor. Enter color, or standard X color 
specification. 
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Table 7-3 Resource Settings (continued) 

„ ., Command-Line 

Resource Name 

Argument 



Specifies 



boldColor 
selectColor 



-boldColor color 
-selectColor color 



Application name with regard to the resources set. Use 
this when starting multiple sessions that you want 
configured differently. 

Color used for text marked bold. 

Color used to indicate selected text. 



blinkCursor 



Specifies whether the cursor blinks. Set the resource to 
True for a blinking cursor, or False for a non-blinking 
cursor. 



blinkColor color 



-blinkColor color 



reverseColor color -reverseColor color 



color.O through color. 15 none 



Color assigned to blinking characters. When this 
resource is set, the characters display in the specified 
color and do not blink. 

Color assigned to reverse- video characters. Those 
characters are reversed and then displayed in the 
specified color. 

The color associated with the numbers through 15. 



bgOFg7 



(Tek340 only) Color is the background, color 7 is the 
foreground. Use the color.O through color. 15 command 
to specify the colors used. 



printer 


-Pprintername 


iconic 


-iconic 


geometry 


-geometry 


title 


-T or -title 


font.normal 


-fn 


font.normalWide a 


-fnw 



The printer to be used. 

The emulator starts with the window iconified. 

Geometry specification of the client. Default is 80x24. 



Title of the client as shown by the window manager. 

Standard 80 column font. Default is LuciV2RT12. 

Double-wide version of standard font. Default is 
tekdw80. 



font.normalBottom 3 -fnb 



Double- wide, double-high version of the standard font 
(bottom half). Default is tekdwdhb80. 



font.normalTop a 



font.condensed 



-fnt 



-fc 



Double- wide, double-high version of the standard font 
(top half). Default is tekdwdht80. 

Standard 130-column condensed font. Default is 
LuciV2NT12. 
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Table 7-3 Resource Settings (continued) 



Resource Name 


Command-Line 
Argument 


Specifies 


font.condensedWide a 


-few 


Double-wide version of the condensed font. Default is 
tekdwl32. 


font.condensedBottom a 


-feb 


Double-wide, double-high version of the condensed 
font (bottom half). Default is tekdwhbl32. 


font.condensedTop a 


-fct 


Double-wide, double-high version of the condensed 
font (top half). Default is tekdwhtl32. 


iconName 


-n 


The name that displays at the bottom of an icon when a 
window is iconified. 


displayMenuBar 




Specifies whether the menubar displays at the top of 
the emulator window. 



The double- wide versions of the normal and condensed fonts must be the same height as the font, and 
double the width. 

Examples 

This example opens a Telnet window titled Sam's Window on a network 
computer named Sierra: 

xpsh -display sierra: tek220 -T "Sam's Window"\ -e telnet 

This example opens a Telnet window on a Tek340 terminal emulator on the 
network computer named Spruce with these attributes: white foreground, black 
background, located 30 pixels in each direction from the lower right corner, and 
titled Telnet: 

xpsh -display spruce : tek340-fg white -bg black\ -geometry -30-30 -T "Telnet" -etelnet 
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Keyboard Translation Settings 

In addition to the resource settings, keyboard translations can be set in 
the .Xdefaults file to override the predefined action for a key. The keyboard 
translations act as macros, redefining and binding a sequence of ASCII 
characters or an escape sequence to a key press. The keyboard translation 
syntax is a subset of the X toolkit Translation Manager syntax, supporting only 
keypress events, designated as <Key>. 

Terminal emulators have a predefined action for most keys on the keyboard 
(most often, an ASCII character or an ASCII escape sequence). For example, 
when you press the A key, an a is sent. Pressing the F6 key on a VT220 
keyboard, sends Escape [ 1 7 ~. Some keys, however, may have no predefined 
action. 

Each key press can be bound in these ways: 

• string (ASCII character or "printable characters") 

• secure() 

• print() 

Specifying a String Action Example 

For string actions, the ASCII character is one number in the range 0-255 
decimal. Numbers can be decimal, octal, or hex. Enter printable characters 
(such as numbers or letters) in double quotation marks. 

This example shows a translation table for a log-in keyboard macro with the 
Tek340 emulator: 

tek340 . translations : ^override \ 



Key>F5 
Key>F6 
Key>F7 



string ( "joe" ) string(Oxa) \n\ 
string ("vt220") string (Oxa) \n\ 
string ("DECWRITE") string (Oxa) 



The override argument must be given at the beginning of the keyboard macro. 
Pressing the F5 key enters the user name joe and a line feed. Pressing the F6 key 
sets the terminal type as vt220 and enters a line feed. Pressing the F7 key starts 
the DECWrite application. Using this example, three key presses log you in and 
starts an application. 
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Securing the Keyboard Example 

The secure() setting directs all keyboard actions to a specified Tek220 or 
Tek340 emulator window regardless of where the cursor is positioned on the 
display. To use the secure function, you must first define a key to invoke the 
secure function. In these examples, the F6 key invokes the secure function on 
Tek220 and Tek340 emulator windows. 

tek220 . translations : #override <Key>F6 : secure () 
tek340 . translations : #override <Key>F6 : secure () 

Printing Example 

This example sets the shifted keypad 8 key to perform a print screen showing 
ASCII characters only with no character attributes: 

Shift<Key>KP_8 : print () 

To print to a DEC printer using the shifted keypad 8 key, showing character 
attributes such as bold, underline, and character width and height, enter: 

Shift<Key>KP_8 : print ("DEC") 

Note: There is a limit of one X event per translation. An X event 
represents one key, or one key Shifted. For example, each X 
event in the first example above is carried out by pressing a single 
key (F5, or F6, or F7). The Setup example uses the Shift and 
keypad 7 keys. For more information about translations, refer to 
the xterm man page. 

Specifying Keyboard Translation Modifiers 

Keyboard translation modifiers precede the event specification. For example, in 
the following line, Ctrl is the modifier, Key is the X event, Fl is the key that is 
pressed, and print is the action: 

Ctrl <Key> Fl : print() 

This example means that pressing and holding the Control key and then 
pressing the Fl key causes a print action. 

If a modifier is immediately preceded by a tilde character (~), it specifies that 
the modifier must not be pressed. A list of modifiers can also be preceded by an 
exclamation point (!) which specifies that pressing only the specified modifiers 
causes the action. 
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For example, to specify that the Alt key must be pressed and that the Shift key 
must not be pressed, the tilde is placed in front of Shift: 

Alt -Shift <Key> F7 

To specify that the Control and Alt keys must be pressed and that no other 
modifiers can be pressed, the exclamation point is placed at the beginning of the 
line: 

! Ctrl Shift <Key> F5 
Table 7-4 lists the supported keyboard translation modifiers. 
Table 7-4 Supported Keyboard Translation Modifiers 



Modifier 


Description 


Modifier 


Description 


None 


No modifiers or buttons 


Mod5 


Mod5 modifier bit 


Any 


Any modifiers or buttons 


Meta 


Meta key modifier 


Ctrl 


Control modifier bit 


Hyper 


Hyper key modifier 


Shift 


Shift modifier bit 


Super 


Super key modifier 


Lock 


Lock modifier bit 


Alt 


Alt key modifier 


Modi 


Modi modifier bit 


Button 1 


Pointer button 1 


Mod2 


Mod2 modifier bit 


Button2 


Pointer button 2 


Mod3 


Mod3 modifier bit 


Button3 


Pointer button 3 


Mod4 


Mod4 modifier bit 





The Meta, Hyper, Super, and Alt modifiers are useful only if a modifier bit 1 
through 5 is bound to a key with that name. (Use xmodmap to map keys.) 

For example, to find out which modifier bits are free: 

xmodmap -pm 
To bind the Hyper key to the PF4 key on the VT keyboard: 

xmodmap -e "keysym KP_F4 = KP_F4 Hyper_L Hyper_R" 
To bind the Hyper key to modifier bit 4 (mod4): 

xmodmap -e "add mod4 = Hyper_L" 
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Specifying Visual Character Attributes 

To specify a character attribute, use the numbers in the table below. The Ps 
values are ANSI values that represent a visual attribute. You can specify 
multiple Ps values, and they are applied in the order given. 

Character attributes are entered using this syntax: 

CSI Ps ; Ps m 

where CSI is the control character (whose decimal value is 155), and Ps is the 
attribute number. Separate multiple attributes with a semicolon. In this 
example, text is displayed as bold: 

CSIlm 

In this example, text is displayed as bold, blinking, and underlined: 
CSI 1;5;4 m 

In this example, the display background is blue, and the foreground is yellow: 
CSI 44;33 m 

After you enter an attribute, the emulator applies that attribute to all new 
characters received. Table 7-5 lists the available character attributes: 
Table 7-5 Available Character Attributes 



Ps 


Attribute 


Ps 


Attribute 





All attributes off 


33 


yellow foreground 


1 


Bold 


34 


blue foreground 


4 


Underline 


35 


magenta foreground 


5 


Blinking 


36 


cyan foreground 



7 Negative image 

8 Invisible 
22 Bold off 



37 white foreground 

40 black background 

41 red background 



24 Underline off 



42 green background 



27 Negative image off 

28 Invisible off 

30 black foreground 

3 1 red foreground 



43 yellow background 

44 blue background 

45 magenta foreground 

46 cyan foreground 



32 green foreground 



47 white foreground 
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Chapter 7 Tek220 and Tek340 Emulators 



Setting ttys for Tek220 Sessions 



Telnet, Cterm, and LAT sessions all use a VT220 terminal emulator. If you 
have applications that use DEC multinational extended character sets, you need 
to turn on 8-bit mode. The escape sequence commands change between 7-bit 
and 8-bit mode. To configure ttys for 8-bit mode: 

# stty tabs cs8 -parenb -istrip 

tabs accepts tab characters without converting them to spaces 

cs8 turns on 8-bit character sequences 

-parenb turns off parity 

-istrip turns off stripping off the high bit 

The pass8 parameter can be substituted for cs8, -parenb, and -istrip: 

# stty tabs pass8 
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Printing 



This appendix includes information about printing text and files. The network 
computers are equipped with various printing capabilities. There is the spooler 
which runs locally on the network computer, the Print Screen key, and the 
data_xp utility which opens a socket connection from the host to the network 
computer. Each enables you to print files and text-only screens to local and 
remote printers. 



Printing Using the Spooler 



A simplified version of a BSD spooler runs locally in the network computer, 
adding the ability to print text within local Tek3270, Tek220, Tek340, and 
Teemx emulators. The print request can be set to a printer connected to a local 
network computer, to a remote printer on the network, or to another network 
computer. The spooler allows background processing of the print request and 
also accepts requests from other machines. The spooler settings cannot be saved 
in NVRAM. This section describes the steps for printing on a local printer and 
on a remote printer. 
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Using a Local Printer 

To use a local printer: 



• Set up a local print queue for the spooler using the following commands in 
the remote configuration file (xp.cnf). When printing, a printer queue on the 
host forwards the print request to a local queue on the network computer. 

- enable_print_spooler 

- spooler_size 

- spooler_local_queue 

Refer to Chapter 2, Remote Configuration for information about these 
commands. 

• If using Serial Ports, configure them to match the settings on the printer. Use 
either the Serial Ports Configuration commands in the xp.cnf file, or the 
Peripheral Ports menu in Setup. Refer to Chapter 2, Remote Configuration or 
Chapter 3, Setup for details about each method. 

• Reboot the network computer to read and update the new print queue and 
serial port settings. 

• On the host, create a new queue pointing to the network computer's local 
print queue. If your host has a specialized system administration tool (such 
as Hewlett-Packard's SAM or IBM's SMIT), use it to add the queue. Refer 
to your host documentation for information about creating print queues. 

Example 

The following example shows the steps for setting up a local print queue on a 
network computer and UNIX host that does not have a specialized system 
administration tool. 

1. Set up the local print queue on the network computer using these xp.cnf 
commands. 

enable_print_spooler YES 
spooler_size 8096 
spooler_local_queue lp PPO 

2. If using a serial port, configure the port to match the settings on the printer. 
Use the Serial Ports Configuration commands in the xp.cnf 'file. 

3. Reboot the network computer to read and update the xp.cnf 'file. 
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4. On the host, edit the /etc/printcap file to create a new queue pointing to the 
network computer's local print queue. If your host has a specialized system 
administration tool (such as Hewlett-Packard's SAM, IBM's SMIT, or the 
Sun Solaris), use it to add the queue. 

Note: The /etc/printcap applies only to the Sun OS or the Solaris 2. 4 
or below. For Solaris 2.5 or above, use these command lines: 

/usr/lib/lpadmin 
/usr/lib/lpadmin 
/usr/lib/lpadmin 
/usr/lib/lpadmin 
/usr/lib/lpadmin 

The printer database file for Solaris 2.5 or above is /etc/printers. conf. 

Solaris Example: 

a. Run admintool on Solaris, as shown in Figure A-l. 



p 


local4 


-s 


ncdu876 


p 


local4 


-o 


If =/usr/adm/lpd-errs 


p 


local4 


-o 


sd=/usr/spool/local4 


p 


local4 


-o 


rm=ncdu9 76 


p 


local4 


-o 


rp=local4 



Admintool: Users 



J 



File Edit Browse 



Help 



U3er Name 



User ID 



Comment 



adm 

bin 

daemon 

listen 

IP 

noaccess 



1 

37 

71 

60002 



Admin 



Network Aitain 
Line Printer Admin 
No Access User 



Host: solar 



Figure A-1 Solaris admintool 
b. On the Browse menu, select Printers. 
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c. On the Edit menu, select Add Access to Printer and the Add Access to 
Printer dialog appears, as shown in Figure A-2. 



1 ' — 1 

■— Admintool: Add Access To Printer 


Print Client: 


solar 


Printer Name: 
Print Server: 




I 


Description: 


I 


Option: 


J Default Printer 








OK 


App 


y Reset Cancel Help 







Figure A-2 The Add Access to Printer Dialog 

d. In the Printer Name box, enter Ip. 

e. In the Print Server box, enter the fully qualified domain name for the 
NC. For example: sierra.ncd.com. 

f. Select Apply. 
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If, instead of using a system administration tool to edit the /etc/printcap file, 
you are using the lp queue specified in the spooler_local_queue 
command above, the entry in /etc/printcap would look like this: 

userl_queue : \ 

lp= : \ 

rm=sierra : \ 

rp=lp:\ 

sd=/usr/spool/lpd/userl_queue : \ 

mx= 8 9 6 : \ 

If =/usr/ spool/ lpd/ERRORLOG: 

In this example, the queue name is userl_queue, the remote printer queue is 
lp, the network computer name is sierra, the location of the spooler queue is 
/usr/spool/lpd/userl_queue, the spooler size is 8096 bytes, and the error file 
name is ERRORLOG. Refer to the printcap man page for details about each 
line and other settings that can be used. 

5. Make a new subdirectory for the new queue. In this example, the new 
subdirectory is userl_queue in /usr/spoolApd: 

# mkdir /usr/spool/lpd/userl_queue 

Be sure to enable permissions as needed. Once the queues are set up and the 
printer is connected to the appropriate port, print requests can be sent. 
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Using a Remote Printer 

To use a remote printer: 

• On the remote host (the host to which the printer is connected), add the 
network computer's name to the /etc/hosts.equiv file. This sets up the 
network computer as a "trusted user" with the remote host and allows access 
without issuing a password. 

• Set up a remote print queue pointing to the remote machine using the 
following commands in the remote configuration file (xp.cnf). When 
printing, a printer queue on the local host forwards the print request to the 
remote machine. 

- enable_print_spooler 

- spooler_size 

- spooler_remote_queue 

Refer to Chapter 2, Remote Configuration for information about these 
commands. 

• Reboot the network computer to read and update the xp.cnf 'file settings. 

• On the remote host, make sure that the queue name specified with the 
spooler_remote_queue command is running on the remote host. 

Example 

The following example shows the steps for setting up a remote print queue on 
a UNIX host that does not have a specialized system administration tool. 

1. Set up the remote print queue on the network computer using these xp.cnf 
commands: 

enable_print_spooler YES 

spooler_size 8096 

spooler_remote_queue lp sierra printerl 

Reboot the network computer to update with the new xp.cnf and serial port 
settings. 

2. On the remote host sierra, make sure that the remote queue name printerl 
exists and is running. 

Once the queues are set up and verified, print requests can be sent. 
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Defining a Print Screen Key 



A Print Screen key is used to print the contents of a local terminal emulator 
window, for example Tek220, Tek340 or Tek3270. To define a Print Key, use 
the keyboard translations settings (added to the .Xdefaults file) to assign the 
Print Key function to any key you like. In this example, the F2 key acts as the 
Print Screen key on the Tek220 emulator: 

tek220 . translations : #override <Key>F2 : print () 

For detailed information about the keyboard translations, refer to the Keyboard 
Translations Settings topic in your NCD NCBridge Installation and 
Configuration manual. 



data_xp Application 



data_xp is an application that runs on the host and is used to open a socket 
connection over the network from the host to the network computer. This socket 
connection is necessary when using the net-to-port feature to print files. 
Multiple devices can be connected to multiple serial and parallel ports. When 
printing, data_xp does not change the original format of the file. It prints the 
file exactly as it appears on the host application. 

The data_xp application can also be used as an example when creating your 
own printing applications for reading from and writing to a port. data_xp is 
located in /tekxp/ 'examples for UNIX and Windows NT hosts, and 
[TEK.XP.SRC] for VMS hosts. 
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Printing Files Using data_xp 

To print a file using data_xp: 

1 . Configure the serial or parallel port(s) to use on the network computer. You 
can use multiple ports simultaneously for multiple devices. Use the 
Net-to-Port configuration commands in the remote configuration file 
(xp.cnf), or enter Setup and use the Peripheral Ports options. Be sure to 
specify which socket is to be used. 

2. Reboot the network computer to update with the new settings. 

3. Connect the printer to the configured port on the network computer. 

4. The file to be printed must be saved in a format that the printer can 
understand, for example, ASCII format for an ASCII printer, or PostScript 
format for a PostScript printer. Refer to your application' s documentation for 
information about saving in a specified format. 

5. Use data_xp to read the file and send it to the printer. Enter the network 
computer's address (or name if using domain name service) and the filename 
to print: 

# data_xp -addr network computer address -in filename 

Optional data_xp parameters are: 



-tdenet 
-debug 
-nctld 



-dtime integer 



specifies the TDEnet protocol. 

prints debug information. 

specifies no Ctrl-D at the beginning and end of a file sent 
to the printer. By default, data_xp sends a Ctrl-D at the 
beginning of the file, waits for a reply, sends the file, 
sends a Ctrl-D, waits for a reply, and sends a final Ctrl-D. 
If using a PostScript printer, do not use this option. 

specifies a delay of seconds when sending Ctrl-D or 
when checking for a network connection (-nctld). The 
default is 5 seconds. 
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Printing Files Using Teemx 

Note: The Teemx client provides local 3270 and 5250 terminal 
emulators. 

To print a file using Teemx: 

1 . Configure the serial or parallel port(s) to use on the network computer. You 
can use multiple ports simultaneously for multiple devices. Use the 
Net-to-Port configuration commands in the remote configuration file 
(xp.cnf), or enter Setup and use the Peripheral Ports options. Be sure to 
specify which socket is to be used. 

2. Reboot the network computer to update with the new settings. 

3. Connect the printer to the configured port on the network computer. 

4. Start the Teemx emulation client. 

5. Select the "Printer Setup" option from the "File" pull-down menu. This 
brings up the "Text Printer Settings" dialog box. Available print queues are 
listed. Choose a printer by entering the name of the desired printer or by 
double-clicking on the entry in the queue list. To accept printer settings, click 
"OK". To abort, click "CANCEL". 

6. Here is a typical example of printer settings: 
enable_print_spooler YES 
spooler_size 10000 
spooler_local_queue lpO PPO 
spooler_local_queue lpl SPO 
spooler_remote_queue lp2 128.181.189.98 
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Serial and Parallel Ports 

Figure A-3 shows the back panel of the NC900 series network computer and the 
placement of the serial and parallel ports (the parallel port is an option). 



Serial Port 1 



Printer Parallel Port (optional) 




Serial Port 



Figure A-3 Back Panel of the NC900 Network Computer 
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Serial Ports 



There are two serial ports, Serial Port and Serial Port 1. Figure A-4 shows the 
serial port diagram. The pinouts (listed in Table A-l) are the same for both 
ports. 



RS232 



A 



V 



RS232 
1 >• 5 



<Q>\ .... /O 



6 -► 9 



Figure A-4 Serial Port Diagram 



Table A-1 Serial Port Pinouts 



Pin Number 


Signal Name 


1 


DCD Data Carrier Detect 


2 


RXD Receive Data 


3 


TXD Transmit Data 


4 


DTR Data Terminal Ready 


5 


SG Signal Ground 


6 


DSR Data Set Ready 


7 


RTS Request To Send 


8 


CTS Clear To Send 


9 


Rl Ring (not connected) 
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Parallel Port Pinouts 

A 25 -pin female Centronics-compatible parallel port is available on the NC900 
Series network computers as an option. Figure A-5 shows the parallel port 
diagram and Table A-2 lists the parallel port pin numbers and signal names. 



13 


-* 




1 














C v .*.*.* •*•*•* .*•*•* .*.*./ ) 














26 




< 


14 



Figure A-5 Parallel Port Diagram 



Table A-2 Parallel Port Pinouts 



Pin Number 


Signal Name 


Pint 


Strobe- 


Pin 2-9 


DATA 0-7 


Pin 10 


ACK~ 


Pin 11 


BUSY 


Pin 12 


PERROR 


Pin 13 


SELECT 


Pin 14 


AUTOFD- 


Pin 15 


ERROR- 


Pin 16 


INIT- 


Pin 17 


SELECTIN- 


Pin 18-25 


GROUND 
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Keyboards 



This appendix describes the optional keyboards available with a network 
computer, the key codes and default keysym-to-key-code mappings the 
keyboards use, how to remap key codes, and how to set keyboard configuration. 

Optional Keyboards B-2 

French Canadian Keyboard B-3 

Using UIS with a French Canadian Keyboard B-4 

Key Codes, Keysyms, and Key Mappings B-5 

Keyboard Figures showing Key Codes for Supported Keyboards B-5 

Key Codes for the 101 with Setup North American Keyboard B-6 

Key Codes for the 104 Key Windows 95 Keyboard, North AmericanB-6 

Key Codes for the 101 with Pause North American Keyboard B-7 

Key Codes for the 102 with Setup United Kingdom Keyboard B-7 

Key Codes for the 102 with Pause United Kingdom Keyboard B-8 

Key Codes for the VT200/LK401 -Style North American Keyboard.. B-8 

Key Codes for the UNIX Keyboard B-9 

Key Codes for the 3270 Keyboard B-10 

(See the 3270/3 179G User Manual for information about this keyboard.) 

Key Codes for the Sun V Keyboard, KS 1 B-10 

Key Codes for the 105 Key Windows 95 Keyboard, European B-ll 

Eurokey Keyboard B-12 

Default Key Maps for Keyboards B-12 

Remapping Key Codes B-41 

7-Bit International Fonts B-42 

Disabling the Keyboard Reboot Function B-43 

NumLock B-44 

National Keyboard Support B-45 

DECwindows Keyboard Differences B-48 

Customizing the Keyboard Configuration B-48 

Keyboard LEDs B-49 
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Optional Keyboards 



You can order a network computer with one of several keyboard types — 
Windows 95, Sun V, or 3270 — in a variety of nationalities. 

Table B-l shows the available nationality options for each keyboard type 
available from NCD. Additionally, NCD can support a variety of customized 
keyboards. 

Table B-1 Keyboard Nationalities and Options 

Keyboard Option 



Nationality 


SunV 


3270 


NCD Windows 95 


North American 


KS1 


XPFYN 


KB-US 


Danish/ 
Norwegian 








Japan 








French 




XPFYB 


KB-FR 


German 




XPFYG 


KB-GR 


Italian 






KB-IT 


Spanish 








French Canadian 






KB-FC 


Swedish/Finnish 






KB-SF 


Swiss-German 








United Kingdom 


XPFSA 


XPFYA 


KB-UK 


Latin American 






KB-LS 



Your network computer is factory-configured for the keyboard type and 
nationality you ordered. You can change keyboards at a later date, and you can 
display the Setup messages and text in a language other than your keyboard 
nationality. Use selections on the Main Menu of Setup to specify the keyboard 
type, keyboard nationality, and the language. 

The Katakana 102 keyboard selection now supports a 105 -key Katakana 
keyboard. This keyboard has a Kana Lock key and LED that are supported with 
the JUS Language Shift mechanism. For more information, refer to Table B-9. 
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French Canadian Keyboard 

This topic presents three ways to set up a network computer to use a French 
Canadian Windows 95 keyboard for Unix and ICA sessions. 

Boot Monitor Method 

This method involves entering two commands at the Boot Monitor prompt: 

1. Using the keyid command, set the LAYOUT to CUSTOM in the boot ROM. 

2. Use the kfile command to set the custom keyboard mapping file name to 
kbl02frca0001. (You can also use the keyid command to do this.) 

Remote Configuration File Method 

This is an alternative to entering commands at the NC keyboard: 

1. Put these commands in the xp.cn/ remote configuration file: 

keyboard_type CUSTOM 
key_map_file kbl02f rcaOOOl 

Setup Method 

Another alternative is to set up the NC for the French Canadian keyboard to use 
local setup. 

1. In setup, set the Keyboard Type to CUSTOM. 

2. Set the Mapping File to kbl02frca0001. 

You can optionally turn on or turn off the compose sequences in the file using 
the compose _sequences YES I NO command in xp.cnf Another way to do this 
is to use the Compose Sequences button in setup. 
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Using UIS with a French Canadian Keyboard 

This topic explains how to configure a network computer to use NCD 
WinCenter for MetaFrame or Citrix UIS (Unix Integration Services) on a 
French Canadian keyboard. This provides full functionality for Unix and 
Windows sessions. 

1. Specify the kbl02frca0001 (French Canadian keyboard) file as the 
keyboard file in the remote configuration (xp.cnj) file (or manually assign 
it in the TekSetup menu). 

2. On the Windows NT or Windows 2000 server, go to Control Panel > 
Keyboards > Input Locales and select the "French Canadian-Multilingual" 
keyboard type. This allows you to use the special AltCar key as well as enter 
your name at the logon prompt. 

3. Navigate to Start > Programs > Uis and select the Configuration Manager 
tab. 

4. For users connecting over an X protocol, select French Canadian - 
Multilingual. 

5. In the left frame of the Configuration Manager dialog, expand the Clients 
folder and select the group or user you are setting up. 

6. Click the Other tab, then right click on the keyboard layout item. (Note, this 
item is grayed out.) 

7. Uncheck the "Use default" command. 

8. From the drop-down list of keyboard types, select the Canadian French - 
Multilingual keyboard. 

9. Right click on the keyboard layout item and select the Save command. 

10. Use the keymapper utility included in UIS to set up special keys and remap 
any incorrectly mapped keys. You can specify mappings on a per user or 
group basis. 
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Key Codes, Keysyms, and Key Mappings 

Each style of keyboard used by the network computer has a specific set of key 
codes that are transmitted by its keys. The key code assignments never change 
for a particular keyboard. You can assign from one to four keysyms, which are 
the identifiers for particular characters or control functions, to each key code. 
Keysyms define the character(s) generated when the key is pressed. Key 
mappings are sets of keysym-to-key-code assignments that allow the user 
flexibility in choosing what character(s) each key produces. Default mappings 
are defined for each keyboard and nationality. You can generate other 
mappings, such as the Dvorak keyboard. 

Key Codes for Supported Keyboards 

Figures B-l through B-ll show the key codes for the keyboards NCBridge 
supports. 



NCBridge Reference Manual B-5 



m 

Appendix B 



B0BB BBBB BBSS BBB 



15 23 31 39 47 55 63 71 79 87 94 102 



95 103 106 



QOBDDBBBBBDBBBB BBS BBBB 



22 30 38 46 45 54 62 69 70 78 77 86 93 100 110 111 118 119 126 127 134 140 



EBBBBBBBBBBBBB 


21 29 37 44 53 52 61 68 75 76 85 92 99 


nnnnnnnsnnnPH 



B 


B 


g 




B 


B 


n 

[PgUp] 


+ 


108 109 117 




116 125 133 




BBB 


132 



28 36 35 43 51 60 59 67 74 83 84 90 



115 123 124 



B^BBBBBBBBBBBB 



m no 



26 34 42 41 50 58 57 66 73 81 82 



113 122 130 



BBB 



105 104 114 



Figure B-1 Key Codes for the 101 with Setup North American Keyboard 
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Figure B-2 Key Codes for the 104 Key Windows 95 Keyboard, North American 
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B BBBQ BBBB BBBB 






15 23 31 39 47 55 63 71 79 87 94 102 95 103 106 



Nun- 


SB 


Scroll 



BBBBBBBBBBBBBE 



B 


B 


[ Page l 



BBBB 



22 30 38 46 45 54 62 69 70 78 77 86 93 110 



111 118 119 126 127 134 140 



BBBBBBBBBBBB 



^BBBBBBBBBBBF^ 



Delete End 


g 




B 


B 


[pgUpJ 


+ 


08 109 117 




116 125 133 




B 


□ 


B 


132 



28 36 35 43 51 60 59 67 74 83 84 90 98 



115 123 124 



BBBBBBBBBB 



B BBB 



26 34 42 41 50 58 57 66 73 81 82 



113 122 130 



BBB 



105 104 114 



Figure B-3 Key Codes for the 101 with Pause North American Keyboard 
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Figure B-4 Key Codes for the 102 with Setup United Kingdom Keyboard 
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Figure B-5 Key Codes for the 102 with Pause United Kingdom Keyboard 
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Figure B-6 Key Codes for the VT200/LK401 -Style North American Keyboard 
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21 


29 37 44 53 52 61 68 75 76 85 92 99 I " 


fc-nlr-l 


DOOOOOOOOODOO M 



28 36 35 43 51 60 59 67 74 83 84 90 110 



□ 000000000m 



26 34 42 41 50 58 57 66 73 81 82 27 97 



:i 



25 96 33 



65 40 56 



B 


□ 


| Scoll | 


m 



95 103 101 126 



OOOO 



111 127 134 12 



BO 


n 


+ 


116 125 133 


□ 00 


132 



115 


123 


124 




:End ] [, [ P ,D„_ 




113 122 130 


I I 


l°" I 


129 







120 121 



Figure B-7 Key Codes for the UNIX Keyboard 



F13 F14 F15 F1B F17 F18 F19 F20 F21 F22 F23 F24 

16 24 32 40 48 56 64 72 80 88 95 103 



000000000000 



15 23 31 39 47 55 63 71 79 87 94 102 







00 



000000000O000 



22 30 38 46 45 54 62 



70 78 77 86 93 110 



000000000O00 



21 29 37 44 53 52 61 68 75 76 85 92 99 



0000O0000OOO 



28 36 35 43 51 60 59 67 74 83 84 90 91 



00000000000O 



26 27 34 42 41 50 58 57 66 73 81 82 



□ N.im □i:.i: □', 



111 118 119 126 127 134 140 



OOBO 



108 109 117 116 125 133 132 



o oooo 



107 115 123 124 131 



OBO OO 



105 106 114 113 122 130 



o 
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Figure B-8 Key Codes for the 3270 Keyboard 



B BBBB BBBB BBBB 



E 



BBBB 
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79 87 94 102 95 103 106 
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w 
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BBBBBBBBBBB 



BBB 



28 36 35 43 51 60 59 67 74 83 84 90 
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B 
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BOB 
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Figure B-9 Key Codes for the Sun V Keyboard, KS 1 
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0000 0000 0000 



g 





g 



16 15 23 31 39 47 55 63 71 



79 87 94 102 95 103 106 



0000 



ES 



22 30 38 46 45 54 62 69 70 78 77 86 93 110 









[p.g.] 



0000 



111 118 119 126 127 134 140 



t^l 


JO EOOOO 00000 0^ 


21 


29 37 44 53 52 61 68 75 76 85 92 99 I 


\% 


]000Q00000000 98 













108 109 117 






E 


n 

|Pg upj 


+ 


116 125 133 


000 


132 



28 36 35 43 51 60 59 67 74 83 84 90 91 



115 123 124 



0100000000000^ 
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Win Key 
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«. 
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25 147 33 



148 65 149 96 105 104 114 120 121 



Figure B-10 Key Codes for the 105 Key Windows 95 Keyboard, European 
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01 1 3B|3C|3D 
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DC OD OE | 
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53 
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Figure B-11 Eurokey Keyboard 



Default Key Maps for Keyboards 

Tables B-2 through B-6 list the default key maps. The maximum key code that 

can be redefined by the "Alt GR" key (the Japan UNIX Society (JUS) 

mechanism) is 140. Look at the following tables to see which keys cannot be 

given alternate graphics characters — the maximum key code is 255. 

Table B-2 lists keyboard codes. 

Table B-4 lists the keysym differences for other LK401 keyboard versions. 

Table B-5 lists modifier definitions. 

Table B-6 lists compose sequence output keycodes for LK401 keyboards 

(except North American). 

Table B-7 lists compose sequence output keycodes for the 3270 keyboard. 

You can display the key map of your keyboard by entering: 

xmodmap -pm -pk 

Note: LI through L10 have the same keysym value as Fll through 

F20, respectively; Rl through R15 have the same keysym value 
as Fll through F35, respectively. 
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Table B-2 Keyboard Codes for 101, 102 


, VT200 ULTRIX, and UNIX Keysyms 








North American 101 -Setup 

Key Keysyms 

and 

United Kingdom 102-Key 

Keysyms 


North American 

VT200 ULTRIX (ESC) 

Keysyms b 


UNIX Keysyms 


Key 
Code 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


8 


























9 


















ffcc 


L5 (F15) 






10 


















ffc8 


LI (Fll) 






11 


















ffca 


L3 (F13) 






13 


















ffce 


L7 (F17) 






14 


















ffdO 


L9 (F19) 






15 b 


ffbe 


Fl 






ffbe 


Fl 






ffbe 


Fl 






16 


fflb 2 


Escape 






ff91 


KP_F1 






ffc9 


L2 (F12) 






17 










003c 


less 


003e 


greater 


ffdl 


L10 
(F20) 






18 b 










fflb 


Escape 














19 b 










ffc9 


F12 














20 b 










ffca 


F13 














21 


ff09 


Tab 






ff09 


Tab 






ff09 


Tab 






22 


0060 


grave 


OOTe 1 
OOac 2 


ascii- 
tilde 1 

not- 

2 
sign 


0060 


grave 


007e 


ascii- 
tilde 


fflb 


Escape 







a Key codes are shown in decimal; keysym values are shown in hexadecimal. For values that are blank, the 
keysym name is NoSymbol. Shifting alphabetic characters gives the uppercase character, but there is no 
additional shift name or shift value. 

b Refer to Table B-4 for keysym differences for the LK401 VMS (Fl 1), LK401 X (ESC-BS-FL), and LK401 X 
(Fl 1-F13) keyboard selections. 

1 North American 101 -Key Keysyms 

2 United Kingdom 102-Key Keysyms 
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Table B-2 Keyboard Codes for 101, 102, VT200 ULTRIX, and UNIX Keysyms (continued) 






North American 101 -Setup 

Key Keysyms 

and 

United Kingdom 102-Key 

Keysyms 


North American 
VT200 Ultrix (ESC) Keysyms b 


UNIX Keysyms 


Key 
Code 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


23 b 


ffbf 


F2 






ffbf 


F2 






ffbf 


F2 






24 


















ff6a 


Help 


ff6a 


Help 


25 


ffe3 


Control- 

Caps- 
_Lock 2 






ffe3 


Control- 
_L 






ffe5 


Caps- 
_Lock 






26 


ffel 


Shift- 

_L 






ffel 


Shift_L 






ffel 


Shift_L 






27 


005c 1 


back- 
slash 


007c 1 


bar 










ffe2 


Shift_R 






28 


ffe5 


Caps- 

_Lock* 

Control- 

_L 2 






ffe5 


Caps- 
_Lock 






ffe3 


Control- 
_L 






29 


0051 


Q 






0051 


Q 






0051 


Q 






30 


0031 


l 


0021 


exclam 


0031 


l 


0021 


exclam 


0031 


l 


0021 


exclam 


31 


ffcO 


F3 














ffcO 


F3 






32 


























33 b 


ffe9 


Alt_L 






ffe9 


Alt_L 


ff20 


Multi- 
_key 


ffe7 


Meta_L 






34 


005a 


Z 






005a 


Z 






005a 


Z 






35 


0053 


S 






0053 


s 






0053 


s 






36 


0041 


A 






0041 


A 






0041 


A 






37 


0057 


W 






0057 


W 






0057 


W 







a Key codes are shown in decimal; keysym values are shown in hexadecimal. For blank values, keysym name is 
NoSymbol. Shifting alphabetic characters gives uppercase character, but there is no additional shift name or 
shift value. 

b Refer to Table B-4 for keysym differences: LK401 VMS (Fl 1), LK401 X (ESC-BS-FL), 
LK401 X (F11-F13) keyboards. 

1 North American 101-Key with Setup Keysyms. 

2 United Kingdom 102-Key with Setup Keysyms and North American 101 Pause key Keysyms. 
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Table B-2 Keyboard Codes for 101, 102, VT200 ULTRIX 


, and UNIX Keysyms (continued) 








North American 101-Setup 

Key Keysyms 

and 

United Kingdom 102-Key 

Keysyms 


North American 
VT200 Ultrix (ESC) Keysyms b 


UNIX Keysyms 


Key 
Code 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


38 


0032 


2 


0040' 
0022 2 


at' 

quote- 

dbl 2 


0032 


2 


0040 


at 


0032 


2 


0040 


at 


39 


ffcl 


F4 






ffcl 


F4 






ffcl 


F4 






40 










ffe9 3 


Alt_L 






ff20 


Multi- 
_key 






41 


0043 


C 






0043 


C 






0043 


C 






42 


0058 


X 






0058 


X 






0058 


X 






43 


0044 


D 






0044 


D 






0044 


D 






44 


0045 


E 






0045 


E 






0045 


E 






45 


0034 


4 


0024 


dollar 


0034 


4 


0024 


dollar 


0034 


4 


0024 


dollar 


46 


0033 


3 


0023' 
00a3 2 


number- 
sign' 
sterling 


0033 


3 


0023 


number- 
sign 


0033 


3 


0023 


number- 
sign 




























47 b 


ffc2 


F5 






ffc2 


F5 






ffc2 


F5 






48 


















ffcb 


L4 (F14) 






49 


0020 


space 






0020 


space 






0020 


space 






50 


0056 


V 






0056 


V 






0056 


V 







a Key codes are shown in decimal; keysym values are shown in hexadecimal. For values that are 
blank, the keysym name is NoSymbol. Shifting alphabetic characters gives the uppercase 
character, but there is no additional shift name or shift value. 

b Refer to Table B-4 for keysym differences for the LK401 VMS (Fll), 
LK401 X (ESC-BS-FL), and LK401 X (F11-F13) keyboard selections. 

1 North American 101-Key Keysyms. 

2 United Kingdom 102-Key Keysyms. 

3 LK401 keyboard only. 
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Table B-2 Keyboard Codes for 101, 102, VT200 ULTRIX, and UNIX Keysyms (continued) 






North American 101 -Setup 

Key Keysyms 

and 

United Kingdom 102-Key Keysyms 


North American 
VT200 Ultrix (ESC) Keysyms b 


UNIX Keysyms 


Key 
Code 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


51 


0046 


F 






0046 


F 






0046 


F 






52 


0054 


T 






0054 


T 






0054 


T 






53 


0052 


R 






0052 


R 






0052 


R 






54 


0035 


5 


0025 


percent 


0035 


5 


0025 


percent 


0035 


5 


0025 


percent 


55 


ffc3 


F6 






ffc3 


F6 






ffc3 


F6 






56 










ffea c 


Alt_R 






ffea 


Alt_R 






57 


004e 


N 






004e 


N 






004e 


N 






58 


0042 


B 






0042 


B 






0042 


B 






59 


0048 


H 






0048 


H 






0048 


H 






60 


0047 


G 






0047 


G 






0047 


G 






61 


0059 


Y 






0059 


Y 






0059 


Y 






62 


0036 


6 


005e 


ascii- 
circum 


0036 


6 


005e 


ascii- 
circum 


0036 


6 


005e 


ascii- 
circum 


63 


ffc4 


F7 






ffc4 


F7 






ffc4 


F7 






64 


























65 


ffea 


Alt_R 






ffe8 c 


Meta_R 






ffe8 


Meta_R 






66 


004d 


M 






004d 


M 






004d 


M 






67 


004a 


J 














004a 


J 






68 


0055 


U 














0055 


U 






69 


0037 


7 


0026 


amper- 
sand 


0037 


7 


0026 


amper- 
sand 


0037 


7 


0026 


amper- 
sand 



Key codes are shown in decimal; keysym values are shown in hexadecimal. For 
values that are blank, the keysym name is NoSymbol. Shifting alphabetic characters 
gives the uppercase character, but there is no additional shift name or shift value. 

Refer to Table B-4 for keysym differences for the LK401 VMS (Fl 1), 
LK401 X (ESC-BS-FL), and LK401 X (F11-F13) keyboard selections. 
LK401 keyboard only. 
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Table B-2 Keyboard Codes for 101, 102, VT200 ULTRIX 


, and UNIX Keysyms (continued) 








North American 101 -Setup 

Key Keysyms 

and 

United Kingdom 102-Key 

Keysyms 


North American 
VT200 Ultrix (ESC) Keysyms b 


UNIX Keysyms 


Key 
Code 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


70 


0038 


8 


002a 


asterisk 


0038 


8 


002a 


asterisk 


0038 


8 


002a 


asterisk 


71 


ffc5 


F8 






ffc5 


F8 






ffc5 


F8 






72 


























73 b 


002c 


comma 


003c 


less 


002c 


comma 




less 


002c 


comma 


003c 


less 


74 


004b 


K 






004b 


K 






004b 


K 






75 


0049 


I 






0049 


I 






0049 


I 






76 


004f 


O 






004f 


O 






004f 


O 






77 


0030 





0029 


paren- 
right 


0030 





0029 


paren- 
right 


0030 





0029 


paren- 
right 


78 


0039 


9 


0028 


paren- 
left 


0039 


9 


0028 


parenleft 


0039 


9 


0028 


parenleft 


79 


ffc6 


F9 






ffc6 


F9 






ffc6 


F9 






80 


















fifed 


L6 (F16) 






81 b 


002e 


period 


003e 


greater 


002e 


period 






002e 


period 


003e 


greater 


82 


002f 


slash 


003f 


question 


002f 


slash 


003f 


question 


002f 


slash 


003f 


question 


83 


004c 


L 






004c 


L 






004c 


L 






84 


003b 


semi- 
colon 


003a 


colon 


003b 


semi- 
colon 


003a 


colon 


003b 


semi- 
colon 


003a 


colon 


85 


0050 


P 






0050 


P 






0050 


P 






86 


002d 


minus 


005f 


under- 
score 










002d 


minus 


005f 


under- 
score 


87 


ffc7 


F10 






ffc7 


F10 






ffc7 


F10 






88 










ffcb 


F14 















Key codes are shown in decimal; keysym values are shown in hexadecimal. For 
values that are blank, the keysym name is NoSymbol. Shifting alphabetic characters 
gives the uppercase character, but there is no additional shift name or shift value. 

Refer to Table B-4 for keysym differences for the LK401 VMS (Fll), 
LK401 X (ESC-BS-FL), and LK401 X (F11-F13) keyboard selections. 
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Table B-2 Keyboard Codes for 101, 


102, VT200 ULTRIX, and UNIX Keysyms (continued) 






North American 101 -Setup 

Key Keysyms 

and 

United Kingdom 102-Key 

Keysyms 


North American 
VT200 Ultrix (ESC) Keysyms b 


UNIX Keysyms 


Key 
Code 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


89 










ff6a 


Help 






005c 


back- 
slash 


007c 


bar 


90 


0027 


apos- 
trophe 


0022 ' 
0040 2 


quote- 
dbl 1 

at 2 


0027 


apos- 
trophe 


0022 


quote- 
dbl 


0027 


apos- 
trophe 


0022 


quotedbl 


91 


005c 1 

23 2 


backlash 

number- 

2 
sign 


007c 1 
007c 2 


bar 

ascii- 

tilde 2 


005c 


back- 
slash 


007c 


bar 










92 


005b 


bracket- 
left 


007b 


brace- 
left 


005b 


bracket- 
left 


007b 


brace- 
left 


005b 


bracket- 
left 


007b 


braceleft 


93 


003d 


equal 


002b 


plus 


003d 


equal 


002b 


plus 


003d 


equal 


002b 


plus 


94 


ffc8 


Fll 














1005ffl0 


SunF36 






95 


ffOa 3 
ff61 4 


Linefeed 
Print 4 


ffOa 4 


Line- 
feed 4 


ff94 


KP_F4 






ffd2 


Rl (F21) 


ffl3 


Pause 


96 


ffe4 


Control- 
_R 














ffe9 


Alt_L 






97 b 


ffe2 


Shift_R 






ffel 


Shift_L 






ffOa 


Line- 
feed 






98 


ffOd 


Return 






ffOd 


Return 






ffOd 


Return 






99 


005d 


bracket- 
right 


007d 


brace- 
right 


005d 


bracket- 
right 


007d 


brace- 
right 


005d 


bracket- 
right 


007d 


brace- 
right 


100 


005c 1 


back- 
slash 


007c 1 


bar 










ffff 


Delete 







a Key codes are shown in decimal; keysym values are shown in hexadecimal. For 
values that are blank, the keysym name is NoSymbol. Shifting alphabetic characters 
gives the uppercase character, but there is no additional shift name or shift value. 

b Refer to Table B-4 for keysym differences for the LK401 VMS (Fl 1), 
LK401 X (ESC-BS-FL), and LK401 X (F11-F13) keyboard selections. 

1 North American 101-Key Keysyms. 

2 United Kingdom 102-Key Keysyms. 

3 101/102-Setup Key Keysyms. 

4 101/102-Pause Key Keysyms. 



B-18 



NCBridge Reference Manual 



Default Key Maps for Keyboards 



Table B-2 Keyboard Codes for 101, 102, VT200 ULTRIX, 


and UNIX Keysyms (continued) 






North American 101 -Setup 

Key Keysyms 

and 

United Kingdom 1 02-Key s 

Keysyms 


North American 
VT200 Ultrix (ESC) Keysyms b 


UNIX Keysyms 


Key 
Code 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


101 


005c 


backslash 


007c 


bar 










ffd4 


R3 

(F23) 






102 


ffc9 


F12 














1005ffll 


SunF37 






103 


ffb6' 
ff69 2 


Break 
Cancel 2 














ffd3 


R2 

(F22) 






104 


ff54 


Down 






















105 


ff51 


Left 






ff51 


Left 














106 


1000ffl7 


TEK- 

Launcher 


ffl3 


Pause 

c 


1000ffl7 


TEK- 

Launcher 


ffcO 


F3 










107 


ff52 


Up 






ff52 


Up 














108 


ffff 


Delete 






lOOOffOO 


Remove 














109 


ff57 


End 






ff60 


Select 














110 


ff08 


Back- 
space 






ffff 


Delete 






0060 


grave 


007e 


ascii- 
tilde 


111 


ff63 


Insert 






ff63 


Insert 






ffd5 


R4 

(F24) 


ffbd 


KP_- 

Equal 


112 


















ffcf 


L8 
(F18) 







Key codes are shown in decimal; keysym values are shown in hexadecimal. For values that 
are blank, the keysym name is NoSymbol. Shifting alphabetic characters gives the uppercase 
character, but there is no additional shift name or shift value. 

Refer to Table B-4 for keysym differences for the LK401 VMS (Fll), 
LK401 X (ESC-BS-FL), and LK401 X (F11-F13) keyboard selections. 

On the 101/102-Pause keyboard, the Launcher and Pause keys are opposite of the 101/102- 
Setup keyboard. 

101/102 Setup Key KeySyms 

101/102 Pause Key KeySyms 
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Table B-2 Keyboard Codes for 101, 


102, VT200 ULTRIX, and UNIX Keysyms (continued) 






North American 101- 
Key Keysyms 
and 
United Kingdom 102 
Keysyms 


Setup 
-Keys 


North American 
VT200 Ultrix (ESC) Keysyms b 


UNIX Keysyms 


Key 
Code 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


113 d 


ffbl 


KP_1 


ff57 


End 


ffbl 


KP_1 






ffde 


R13 (F33) 


ffbl 


KP_1 


114 c 


ff53 


Right 






ff53 


Right 














115 cd 


ffM 1 
ffb5 2 


KP_4 


ff51 


Left 


ffb4 


KP_4 






ff51 


Left 


ffb4 


KP_4 


116 cd 


ffb7 


KP_7 


ff50 


Home 


ffb7 


KP_7 






ffd8 


R7 (F27) 


ffb7 


KP_7 


117 c 


ff56 


Next 






ff56 


Next 














118 c 


ff50 


Home 






ff50 


Home 














119 c 


ff55 


Prior 






ff55 


Prior 














120 cd 


ffbO 


KP_0 


ff63 


Insert 


ffbO 


KP_0 






ff63 


Insert 


ffbO 


KP_0 


121 cd 


ffae 


KP_- 
Decimal 


ffff 


Delete 


ffae 


KP_- 
Decimal 






ffff 


Delete 


ffae 


KP_- 
Decimal 


122 cd 


ffb2 


KP_2 


ff54 


Down 


ffb2 


KP 2 






ff54 


Down 


ffb2 


KP_2 


123 cd 


ffb5 


KP_5 






ffb5 


KP_5 






ffdc 


Rll (F31) 


ffb5 


KP_5 


124 cd 


ffb6 


KP_6 


ff53 


Right 


ffb6 


KP_6 






ff53 


Right 


ffb6 


KP_6 


125 cd 


ffb8 


KP_8 


ff52 


Up 


ffb8 


KP_8 






ff52 


Up 


ffb8 


KP_8 


126 c 


ff7f 


Num_- 
Lock 






ff92 


KP_F2 






ff7f 


Num_Lock 


ff7f 


Num_- 
Lock 


127 c 


ffaf 


KP_- 
Divide 














ffd6 


R5 (F25) 


ffaf 


KP_- 
Divide 



Key codes are shown in decimal; keysym values are shown in hexadecimal. For blank values, 
keysym name is NoSymbol. Shifting alphabetic characters gives uppercase character; there is 
no additional shift name or shift value. 

Refer to Table B-4 for keysym differences: LK401 VMS (Fll), LK401 X 
(ESC-BS-FL),LK401 X (F11-F13) keyboard selections. 

Key codes 1 14-140 cannot take alternate keysyms. The maximum key code you can assign 
new graphics characters using Alt-GR on 101- and 102-key keyboards is 113. 

Currently there is no Num Lock support. 
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Table B-2 Keyboard Codes for 101 


, 102, VT200 ULTRIX, and UNIX Keysyms (continued) 






North American 101-Setup 

Key Keysyms 

and 

United Kingdom 102-Key 

Keysyms 


North American 
VT200 Ultrix (ESC) Keysyms b 


UNIX Keysyms 


Key 
Code 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


128 c 


























129 c 


ff8d 


KP_ 
Enter 






ff8d 


KP_Enter 






ff8d 


KP_ 
Enter 


ff8d 


KP_ 
Enter 


130 c 


ffb3 


KP_3 


ff56 


Next 


ffb3 


KP_3 






ffeO 


R15 

(F35) 


ffb3 


KP_3 


131 c 


















ff08 


Back- 
space 






132 c 


ffab 


KP_Add 






ffac 


KP_- 

Separator 






ffab 


KP_Add 


ffab 


KP_Add 


133 cd 


ffb9 


KP_9 


ff55 


Prior 


ffb9 


KP_9 






ffda 


R9 (F29) 


ffb9 


KP_9 


134 c 


ffaa 


KP_ 
Multiply 














ffd7 


R6 (F26) 


ffaa 


KP_ 
Multiply 


135 bc 










ff67 


Menu 














136 c 










ffce 


F17 














137 c 










ffcf 


F18 














138 c 










ffdO 


F19 














139 c 










ffdl 


F20 














140 c 


ffad 


KP_ 
Subract 






ffad 


KP_ 
Subract 















Key codes are shown in decimal; keysym values are shown in hexadecimal. For values that 
are blank, the keysym name is NoSymbol. Shifting alphabetic characters gives the uppercase 
character, but there is no additional shift name or shift value. 

Refer to Table B-4 for keysym differences for the LK401 VMS (Fll), 
LK401 X (ESC-BS-FL), and LK401 X (F11-F13) keyboard selections. 

Key codes 1 14-140 cannot take alternate keysyms. The maximum key code you can assign 
new graphics characters using Alt_GR on 101- and 102-key keyboards is 113. 

To access this "key", press Alt_GR in combination with the key for which the keycode is 141 
less than 163; that is, Alt_GR with the grave/notsign key (Key Code 22). 
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Table B-2 Keyboard Codes for 101, 102, VT200 ULTRIX, and UNIX Keysyms (continued) 





North American 101 -Setup 

Key Keysyms 

and 

United Kingdom 102-Key 

Keysyms 


North American 

VT200 Ultrix (ESC) 

Keysyms b 


UNIX Keysyms 


Key 
Code 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


147 


ffe7 


Meta_L 




















147 


148 


ffe8 


Meta_R 




















148 


149 


ff67 


Menu 




















149 


150- 
162 


























163 d 


00a6 2 


broken- 
bar 2 






















165 


















1000ffl7 


TEK- 

Launcher 







Key codes are shown in decimal; keysym values are shown in hexadecimal. For values that 
are blank, the keysym name is NoSymbol. Shifting alphabetic characters gives the uppercase 
character, but there is no additional shift name or shift value. 

Refer to Table B-4 for keysym differences for the LK401 VMS (Fl 1), 
LK401 X (ESC-BS-FL), and LK401 X (F11-F13) keyboard selections. 

To access this "key", press Alt_GR in combination with the key for which the keycode is 141 
less than 163; that is, Alt_GR with the grave/notsign key (Key Code 22). 
United Kingdom 102-Key Keysyms. 
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Table B-3 Keyboard Codes for North American Sun V Keysyms 





Sun V Keysyms 


Key 
Code 


Value 


Name 


Shift Value 


Shift 
Name 


Mode 

Switch 

Value 


Mode 

Switch 

Name 


Shift Mode 

Switch 

Value 


Shift 
Mode 
Switch 
Name 


15 


Oxffbe 


Fl 














16 


Oxfflb 


Escape 














17 


0xff6a 


Help 


0xff6a 


Help 


0xl000ffl7 


Tek- 
Launcher 






18 


0xffc8 


Fll 


0xffc8 


Fll 


0xff69 


Cancel 






19 


0xffc9 


F12 


0xffc9 


F12 


0xff66 


Redo 






20 


Oxffca 


F13 


Oxffca 


F13 


0xl005ff70 


SunProps 






21 


0xff09 


Tab 














22 


0x0060 


grave 


0x007e 


asciitilde 










23 


Oxffbf 


F2 














24 


Oxffcb 


F14 


Oxffcb 


F14 


0xff65 


Undo 






25 


0xffe3 


Control_L 














26 


Oxffel 


Shift_L 














27 


Oxffcc 


F15 


Oxffcc 


F15 


0xl005ff71 


SunFront 






28 


0xffe5 


Caps_Lock 














29 


0x0051 


Q 














30 


0x0031 


l 


0x0021 


exclam 










31 


OxffcO 


F3 














32 


Oxffcd 


F16 


Oxffcd 


F16 


0xl005ff72 


SunCopy 






33 


0xffe9 


Alt_L 














34 


0x005a 


Z 














35 


0x0053 


S 














36 


0x0041 


A 














37 


0x0057 


W 














38 


0x0032 


2 


0x0040 


at 










39 


Oxffel 


F4 














40 


Oxffce 


F17 


Oxffce 


F17 


Oxl005ff73 


SunOpen 






41 


0x0043 


C 
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Table B-3 Keyboard Codes for North American Sun V Keysyms 





Sun V Keysyms 


Key 
Code 


Value 


Name 


Shift Value 


Shift 
Name 


Mode 

Switch 

Value 


Mode 

Switch 

Name 


Shift Mode 

Switch 

Value 


Shift 
Mode 
Switch 
Name 


42 


0x0058 


X 














43 


0x0044 


D 














44 


0x0045 


E 














45 


0x0034 


4 


0x0024 


dollar 










46 


0x0033 


3 


0x0023 


numbersign 










47 


0xffc2 


F5 














48 


Oxffcf 


F18 


Oxffcf 


F18 


0xl005ff74 


SunPaste 






49 


0x0020 


space 














50 


0x0056 


V 














51 


0x0046 


F 














52 


0x0054 


T 














53 


0x0052 


R 














54 


0x0035 


5 


0x0025 


percent 










55 


0xffc3 


F6 














56 


OxffdO 


F19 


OxffdO 


F19 


0xff68 


Find 






57 


0x004e 


N 














58 


0x0042 


B 














59 


0x0048 


H 














60 


0x0047 


G 














61 


0x0059 


Y 














62 


0x0036 


6 


0x005e 


asciicircum 










63 


0xffc4 


F7 














64 


Oxffdl 


F20 


Oxffdl 


F20 


0xl005ff75 


SunCut 






65 


0xff20 


Multi_key 














66 


0x004d 


M 














67 


0x004a 


J 














68 


0x0055 


U 














69 


0x0037 


7 


0x0026 


ampersand 










70 


0x0038 


8 


0x002a 


asterisk 
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Table B-3 Keyboard Codes for North American Sun V Keysyms 





Sun V Keysyms 


Key 
Code 


Value 


Name 


Shift Value 


Shift 
Name 


Mode 

Switch 

Value 


Mode 

Switch 

Name 


Shift Mode 

Switch 

Value 


Shift 
Mode 
Switch 
Name 


71 


0xffc5 


F8 














72 


0xffe7 


Meta_L 














73 


0x002c 


comma 


0x003c 


less 










74 


0x004b 


K 














75 


0x0049 


I 














76 


0x004f 


O 














77 


0x0030 





0x0029 


parenright 










78 


0x0039 


9 


0x0028 


parenleft 










79 


0xffc6 


F9 














80 


0xffe8 


Meta_R 














81 


0x002e 


period 


0x003e 


greater 










82 


0x002f 


slash 


0x003f 


question 










83 


0x004c 


L 














84 


0x003b 


semicolon 


0x003a 


colon 










85 


0x0050 


P 














86 


0x002d 


minus 


0x005f 


underscore 










87 


0xffc7 


F10 














88 


0xl005ff78 


SunAudio- 
Mute 


0xl005ff7a 


SunVideo- 
Degauss 










89 


0xl005ff77 


SunAudio- 
Lower Volume 


0xl005ff7b 


SunVideo- 

Lower- 

Brightness 










90 


0x0027 


apostrophe 


0x0022 


quotedbl 










91 


0xl005ff79 


SunAudio- 
RaiseVolume 


0xl005ff7c 


SunVideo- 

Lower- 

Brightness 










92 


0x005b 


bracketleft 


0x007b 


braceleft 










93 


0x003d 


equal 


0x002b 


plus 










94 


0xl005ffl0 


SunF36 
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Table B-3 Keyboard Codes for North American Sun V Keysyms 





Sun V Keysyms 


Key 
Code 


Value 


Name 


Shift Value 


Shift 
Name 


Mode 

Switch 

Value 


Mode 

Switch 

Name 


Shift Mode 

Switch 

Value 


Shift 
Mode 
Switch 
Name 


95 


0xffd3 


F22 


0xffd3 


F22 


0xff61 


Print 


0xl005ff60 


SunSys- 
Req 


96 


0xff7e 


Mode_switch 














97 


0xffe2 


Shift_R 














98 


OxffOd 


Return 














99 


0x005d 


bracketright 


0x007d 


braceright 










100 


0x005c 


backslash 


0x007c 


bar 


0x00a6 


brokenbar 






101 


0xl005ff76 


SunPower- 
S witch 


0xl005ff7d 


SunPower- 
SwitchShift 










102 


0xl005ffll 


SunF37 














103 


0xffd4 


F23 


0xffd4 


F23 


0xffl4 


Scroll_ 
lock 






104 


0xff54 


Down 














105 


0xff51 


Left 














106 


0xffd2 


F21 


0xffd2 


F21 


0xffl3 


Pause 


0xff6b 


Break 


107 


0xff52 


Up 














108 


Oxffff 


Delete 














109 


0xff57 


End 














110 


0xff08 


Backspace 














111 


0xff63 


Insert 














113 


Oxffde 


F33 


Oxffde 


F33 


Oxffbl 


KP_1 


0xff57 


End 


114 


0xff53 


Right 














115 


0xff51 


Left 


Oxffdb 


F30 


0xffb4 


KP_4 






116 


0xffd8 


F27 


0xffd8 


F27 


0xffb7 


KP_7 


0xff50 


Home 


117 


0xff56 


Next 














118 


0xff50 


Home 














119 


0xff55 


Prior 














120 


0xff63 


Insert 


0xff63 


Insert 


OxffbO 


KP_0 






121 


Oxffff 


Delete 


Oxffff 


Delete 


Oxffae 


KP_ 

Decimal 
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Table B-3 Keyboard Codes for North American Sun V Keysyms 





Sun V Keysyms 


Key 
Code 


Value 


Name 


Shift Value 


Shift 
Name 


Mode 

Switch 

Value 


Mode 

Switch 

Name 


Shift Mode 

Switch 

Value 


Shift 
Mode 
Switch 
Name 


122 


0xff54 


Down 


Oxffdf 


F34 


0xffb2 


KP_2 






123 


Oxffdc 


F31 


Oxffdc 


F31 


0xffb5 


KP_5 






124 


0xff53 


Right 


Oxffdd 


F32 


0xffb6 


KP_6 






125 


0xff52 


Up 


0xffd9 


F28 


0xffb8 


KP_8 






126 


0xff7f 


Num_Lock 














127 


0xffd6 


F25 


0xffd6 


F25 


Oxffaf 


KP_ 

Divide 






129 


0xff8d 


KP_Enter 














130 


OxffeO 


F35 


OxffeO 


F35 


0xffb3 


KP_3 


0xff56 


Next 


132 


Oxffab 


KP_Add 














133 


Oxffda 


F29 


Oxffda 


F29 


0xffb9 


KP_9 


0xff55 


Prior 


134 


0xffd7 


F26 


0xffd7 


F26 


Oxffaa 


KP_ 

Multiply 






140 


0xffd5 


F24 


0xffd5 


F24 


Oxffad 


KP_ 

Subtract 
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Table B-4 Keysym Differences for Other North American LK401 Keyboards 





LK401 Ultrix (ESC) 


LK401 VMS(F11) 


Key 
Code 


Value 


Name 


Shift 
Value 


Shift 
Name 


Value 


Name 


Shift 
Value 


Shift 
Name 


15 


ffbe 


Fl 






ffbe 


Fl 






18 


fflb 


Escape 






ffc8 


Fll 






19 


ffc9 


F12 






ffc9 


F12 






20 


ffca 


F13 






ffca 


F13 






23 


ffbf 


F2 






ffbf 


F2 






33 


ffe9 


Alt_L a 


ff20 


Multi_Key 


ffe9 


Alt_L a 


ff20 


Multi_Key 


47 


ffc2 


F5 






ffc2 


F5 






97 


ffel 


Shift_L 






ffel 


Shift_L 






135 


ff67 


Menu 






ff67 


Menu 






139 


ffdl 


F20 






ffdl 


F20 










LK401 X (E 


SC-BS-FL) 




LK401 X(F11-F 


: 13) 


15 


ffbe 


Fl 


ffl3 


Pause 


ffbe 


Fl 


ffl3 


Pause 


18 


fflb 


Escape 


ffc8 


Fll 


ffc8 


Fll 


fflb 


Escape 


19 


ff08 


Backspace 


ffc9 


F12 


ffc9 


F12 


ff08 


Backspace 


20 


ffOa 


Linefeed 


ffca 


F13 


ffca 


F13 


ffOa 


Linefeed 


23 


ffbf 


F2 


ff61 


Print 


ffbf 


F2 


ff61 


Print 


33 


ffe9 


Alt_L a 


ff20 


Multi_Key 


ffe9 


Alt_L a 


ff20 


Multi_Key 


47 


ffc2 


F5 


ff6b 


Break 


ffc2 


F5 


ff6b 


Break 


97 


ffe2 


Shift_L 






ffe2 


Shift_L 






135 


ff67 


Menu 






ff62 


Execute 






139 


ffdl 


F20 b 






ffdl 


F20 b 







. Unshifted keysym is Multi_key (ff20); shifted keysym is Alt_L on 

non-North American layouts. 
. Alt_L (ffe9) on non-North American layouts. 
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Table B-5 Modifier Definitions 





North American 
101 -Setup Key Modifiers 


International 
102 Key Modifiers 


Modifier 


Key Code Value 


Keysym Name 


Key Code Value 


Keysym Name 


shift 


26 


Shift_L 


26 


Shift_L 


97 


Shift_R 


97 


Shift_R 


lock 


25 


Caps_Lock 


28 


Caps_Lock 


control 


28 


ControlJL 


25 


Control_L 


96 


Control_R 


96 


Control_R 


modi 


33 


Alt_L 


33 


Alt_L 






65 


Alt_R a 




North American 
101 -Pause Key Modifiers 


UNIX Key Modifiers 


shift 


26 


Shift_L 


26 


Shift L 




97 


Shift_R 


27 


Shift_R 


lock 


28 


Caps_Lock 


25 


Caps_Lock 


control 


25 


Control_L 


28 


Control_L 




96 


Control_R 






modi 


33 


Alt_L 


33 


Meta_L 




65 


Alt_R 


65 


Meta_R 




VT200 DEC Modifiers 
(ULTRIX-Esc, VMS-F11) 


VT200 X Modifiers 
(X-ESC, X-F11) 


shift 


26 


Shift_L 


26 


Shift_L 


97 


Shift_L 


97 


Shift_R 


lock 


28 


Caps_Lock 


28 


Caps_Lock 


control 


25 


Control_L 


25 


Control_L 


modi 
mod5 


33 b 


Alt_L b 


33 b 


Alt_L b 


40 d 


Alt_L d 


139 c 


Alt_L c 


56 d 


Alt_R d 


40 d 


Alt_L d 


65 d 


Meta_R d 


56 d 


Alt_R d 






65 d 


Meta_R d 


89 


Help 


89 


Help 



a. Katakana only. 

b. North American only. 

c. International only. Keycode 139 is the F20 key. 

d. LK401 keyboards only. 
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Table B-6 Compose Sequence Output Keycodes for 
VT200 Keyboards (except North American) 



Key 
Code 


Value 


Name 


Shift 
Value 


Shift Name 


141 


00a0 


nobreakspace 


005b 


bracketleft 


142 


OOal 


exclamdown 


005c 


backslash 


143 


00a2 


cent 


005d 


bracketright 


144 


00a3 


sterling 


007b 


braceleft 


145 


00a4 


currency 


007c 


bar 


146 


00a5 


yen 


007d 


braceright 


147 


00a6 


brokenbar 


0023 


numbersign 


148 


00a7 


section 


0040 


at 


149 


00a8 


diaeresis 


0024 


dollar 


150 


00a9 


copyright 


0022 


quotedbl 


151 


OOaa 


ordfeminine 






152 


OOab 


guillemotleft 






153 


OOac 


notsign 






154 


OOad 


hyphen 






155 


OOae 


registered 






156 


OOaf 


macron 






157 


OObO 


degree 






158 


00b 1 


plusminus 






159 


00b2 


twosuperior 






160 


00b3 


threesuperior 






161 


00b4 


acute 






162 


00b5 


mu 






163 


00b6 


paragraph 






164 


00b7 


periodcentered 






165 


00b8 


cedilla 






166 


00b9 


onesuperior 






167 


OOba 


masculine 
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Table B-6 Compose Sequence Output Keycodes for 

VT200 Keyboards (except North American) (continued) 



Key 
Code 


Value 


Name 


Shift 
Value 


Shift Name 


168 


OObb 


guillemotright 






169 


OObc 


onequarter 






170 


OObd 


onehalf 






171 


OObe 


threequarters 






172 


OObf 


questiondown 






173 


OOcO 


Agrave 






174 


00c 1 


Aacute 






175 


00c2 


Acircumflex 






176 


00c3 


Atilde 






177 


00c4 


Adiaeresis 






178 


00c5 


Aring 






179 


00c6 


AE 






180 


00c7 


Ccedilla 






181 


00c8 


Egrave 






182 


00c9 


Eacute 






183 


OOca 


Ecircumflex 






184 


OOcb 


Ediaeresis 






185 


OOcc 


Igrave 






186 


OOcd 


Iacute 






187 


OOce 


Icircumflex 






188 


OOcf 


Idiaeresis 






189 


OOdO 


ETH 






190 


OOdl 


Ntilde 






191 


00d2 


Ograve 






192 


00d3 


Oacute 






193 


00d4 


Ocircumflex 






194 


00d5 


Otilde 






195 


00d6 


Odiaeresis 
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Table B-6 Compose Sequence Output Keycodes for 

VT200 Keyboards (except North American) (continued) 



Key 
Code 


Value 


Name 


Shift 
Value 


Shift Name 


196 


00d7 


multiply 






197 


00d8 


Ooblique 






198 


00d9 


Ugrave 






199 


OOda 


Uacute 






200 


OOdb 


Ucircumflex 






201 


OOdc 


Udiaeresis 






202 


OOdd 


Yacute 






203 


OOde 


THORN 






204 


OOdf 


ssharp 






205 


OOeO 


agrave 






206 


OOel 


aacute 






207 


00e2 


acircumflex 






208 


00e3 


atilde 






209 


00e4 


adiaeresis 






210 


00e5 


aring 






211 


00e6 


ae 






212 


00e7 


ccedilla 






213 


00e8 


egrave 






214 


OOea 


ecircumflex 






215 


OOeb 


ediaeresis 






216 


00e9 


eacute 






217 


OOec 


igrave 






218 


OOed 


iacute 






219 


OOee 


icircumflex 






220 


OOef 


idiaeresis 






221 


OOfO 


eth 






222 


OOfl 


ntilde 






223 


00f2 


ograve 







B-32 



NCBridge Reference Manual 



Default Key Maps for Keyboards 



Table B-6 Compose Sequence Output Keycodes for 

VT200 Keyboards (except North American) (continued) 



Key 
Code 


Value 


Name 


Shift 
Value 


Shift Name 


224 


00f3 


oacute 






225 


00f4 


ocircumflex 






226 


00f5 


otilde 






227 


00f6 


odiaeresis 






228 


00f7 


division 






229 


00f8 


oslash 






230 


00f9 


ugrave 






231 


OOfa 


uacute 






232 


OOfb 


ucircumflex 






233 


OOfc 


udiaeresis 






234 


OOfd 


yacute 






235 


OOfe 


thorn 






236 


OOff 


ydiaeresis 






237 


00b4 


acute 






238 


005e 


asciicircum 






239 


007e 


asciitilde 






240 


0060 


grave 






241- 
254 


00 
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Table B-7 Compose Sequence Output Keycodes 
for the 3270 Keyboard 



Key 
Code 


Value 


Name 


Shift 
Value 


Shift Name 


8 










9 


ffda 


F29 






10 










11 


ffd7 


F26 






12 


ff60 


Select 






13 


ff6b 


Break 


ff6a 


Help 


14 


ffOb 


Clear 






15 


ffbe 


Fl 






16 


ffca 


F13 






17 


ffeO 


F35 






18 


ffd9 


F28 






19 


ffd8 


F27 






20 


ffd6 


F25 






21 


ff09 


Tab 






22 


0060 


grave 


007e 


ascii tilde 


23 


ffbf 


F2 






24 


ffcb 


F14 






25 


ffe3 


Control_L 






26 


ffel 


Shift_L 






27 


003c 


less 


003e 


greater 


28 


ffe5 


Caps_Lock 






29 


0051 


Q 






30 


0031 


l 


0021 


exclam 


31 


ffcO 


F3 






32 


ffcc 


F15 






33 


ffe9 


Alt_L 


ffe7 


Meta_L 


34 


005a 


Z 






35 


0053 


S 
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Table B-7 Compose Sequence Output Keycodes 
for the 3270 Keyboard (continued) 



Key 

Code 


Value 


Name 


Shift 
Value 


Shift Name 


36 


0041 


A 






37 


0057 


W 






38 


0032 


2 




0040 at 


39 


ffcl 


F4 






40 


ffcd 


F16 






41 


0043 


C 






42 


0058 


X 






43 


0044 


D 






44 


0045 


E 






45 


0034 


4 


0024 


dollar 


4 


0033 


3 


0023 


numbersign 


47 


ffc2 


F5 






48 


ffce 


F17 






49 


0020 


space 






50 


0056 


V 






51 


0046 


F 






52 


0054 


T 






53 


0052 


R 






54 


0035 


5 


0025 


percent 


55 


ffc3 


F6 






56 


ffcf 


F18 






57 


004e 


N 






58 


0042 


B 






59 


0048 


H 






60 


0047 


G 






61 


0059 


Y 






62 


0036 


6 


005e 


asciicircum 


63 


ffc4 


F7 
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Table B-7 Compose Sequence Output Keycodes 
for the 3270 Keyboard (continued) 



Key 
Code 


Value 


Name 


Shift 
Value 


Shift Name 


64 


ffdO 


F19 






65 


ffea 


Alt_R 


ffe8 


Meta_R 


66 


004d 


M 






67 


004a 


J 






68 


0055 


U 






69 


0037 


7 


0026 


ampersand 


70 


0038 


8 


002a 


asterisk 


71 


ffc5 


F8 






72 


ffdl 


F20 






73 


002c 


comma 


002c 


comma 


74 


004b 


K 






75 


0049 


I 






76 


004f 


O 






77 


0030 





0029 


parenright 


78 


0039 


9 


0028 


parenleft 


79 


ffc6 


F9 






80 


ffd2 


F21 






81 


002e 


period 


002e 


period 


82 


002f 


slash 


003f 


question 


83 


004c 


L 






84 


003b 


semicolon 


003a 


colon 


85 


0050 


P 






86 


002d 


minus 


005f 


underscore 


87 


ffc7 


F10 






88 


ffd3 


F22 






89 










90 


0027 


apostrophe 


0022 


quotedbl 


91 


005c 


backslash 


007c 


bar 
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Table B-7 Compose Sequence Output Keycodes 
for the 3270 Keyboard (continued) 



Key 

Code 


Value 


Name 


Shift 
Value 


Shift Name 


92 


005b 


bracketleft 


007b 


braceleft 


93 


003d 


equal 


002b 


plus 


94 


ffc8 


Fll 






95 


ffd4 


F23 






96 


ffe4 


Control_R 






97 


ffe2 


Shift_R 






98 


ffOd 


Return 






99 


005d 


bracketright 


007d 


braceright 


100 










101 










102 


ffc9 


F12 






103 


ffd5 


F24 






104 


ff54 


Down 






105 


ff51 


Left 






106 


ff50 


Home 






107 


ff52 


Up 






108 


ff57 


End 






109 


ff63 


Insert 






110 


ff08 


Backspace 






111 


ffdb 


F30 






112 










113 


ffbl 


KP_1 


ff57 


End 


114 


ff53 


Right 






115 


ffb4 


KP_4 


ff51 


Left 


116 


ffb7 


KP_7 


ff50 


Home 


117 


ffff 


Delete 






118 


ff55 


Prior 






119 


ff56 


Next 
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Table B-7 Compose Sequence Output Keycodes 
for the 3270 Keyboard (continued) 



Key 
Code 


Value 


Name 


Shift 
Value 


Shift Name 


120 


ffbO 


KP_0 


ff63 


Insert 


121 


ffae 


KP_Decimal 


ffff 


Delete 


122 


ffb2 


KP_2 


ff54 


Down 


123 


ffb5 


KP_5 






124 


ffb6 


KP_6 


ff53 


Right 


125 


ffb8 


KP_8 


ff52 


Up 


126 


fflb 


Escape 






127 


ff7f 


Num_Lock 






128 










129 


ff8d 


KP_Enter 






130 


ffb3 


KP_3 


ff56 


Next 


131 


ffad 


KP_Subtract 






132 


ffab 


KP_Add 






133 


ffb9 


KP_9 


ff55 


Prior 


134 


ffaa 


KP_Multiply 






135 










136 










137 










138 










139 


ff61 


Print 






140 


ffaf 


KP_Divide 






141 










142 










143 










144 










145 










146 










147 
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Table B-7 Compose Sequence Output Keycodes 
for the 3270 Keyboard (continued) 



Key 

Code 


Value 


Name 


Shift 
Value 


Shift Name 


148 










149 










150 










151 










152 


1000ffl7 


TekLauncher 






153 










154 










155 










156 










157 










158 


fflb 


Escape 
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Eurokey Support 



NCBridge supports the EuroSign keysym for the various keyboard types listed 
in Table B-8. The EuroSign keysym value is 0x20AC. 

Table B-8 EuroSign Character Support 



Keyboard 


Country 


Keystroke 


102 Setup & 102 Pause 


Danish 

French 

Finnish 

German 

Italian 

Norwegian 

Spanish 

Swedish 

Swiss-German 

United Kingdom 


AltGr+E 
AltGr+E 
AltGr+E 
AltGr+E 
AltGr+E 
AltGr+E 
AltGr+E 
AltGr+E 
AltGr+E 
AltGr+4 


3270 


French 
German 
United Kingdom 


AltGr+E 
AltGr+E 
AltGr+4 


SunV 


French 
German 
United Kingdom 


AltGr+E 
AltGr+E 
AltGr+4 
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Remapping Key Codes 



You can modify your keyboard mapping, either by issuing the xmodmap 
command in a start-up script or, or if using the XP 'startup or XPkeymap script, 
by creating a file named .Xkm in the home directory. Here are some examples 
from the xmodmap man page. Valid entries in the .Xkm file have the same form 
as the expressions recognized by xmodmap. 

Example — To remap the mouse buttons so that the left index finger presses 
Button 1 , enter: 

xmodmap -e "pointer =321" 

Example — To remap the Compose key to a Meta key, enter: 
xmodmap -e "keysym Alt_L = Multi_key Meta_L" 

Example — To swap the functions of the Caps Lock key and Ctrl key, include 
the following lines in your $HOME/.Xkm file: 

! Swap CapsLock and ControlL 
i 

remove Lock = CapsLock 
remove Control = Control_L 
keysym ControlL = CapsLock 
keysym CapsLock =Control_L 
add Lock = CapsLock 
add Control = ControlL 

Setup is invoked by any key that has the TekSetup keysym assigned to it. All 
default keyboard layouts have this keysym on the Setup key. Refer to 
Table B-2. The following example shows how to remap the Setup key using the 
NCD-supplied xmodmap. 

Example — To swap the F3 key and the Setup key on LK401 keyboards, enter: 
xmodmap -e "keycode 106 = F3 TekSetup" 

Note: To remove the mapping for the Setup key on LK401 keyboards, 
enter: 

xmodmap -e "keycode 106 = F3 F3" 
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Certain non-standard keysyms, or keysyms that were not standardized until R4, 
are not recognized by many host X libraries. As a result, utilities such as 
xmodmap cannot report the keysym names, only the numeric keysym values. 
The keysyms TekSetup, DRemove, _JUS_Kana_Shift, _JUS_Kana_Lock, and 
Kana_Lock are used on NCD keyboards and are affected by this. 

L_Alt is defined as a modi modifier by default. This can cause problems when 
trying to reach the alternate keysyms in certain applications. One way to work 
around this is to remove it as a modi modifier: 

1. Display what the modifier is. 

xmodmap -pm 

2. Remove the modi modifier: 

xmodmap -e "clear modi" 

3. Display what the modifier is again. The modi keysym should be removed. 

xmodmap -pm 

Note: The procedure above also enables compose capabilities for the 
North American LK401 keyboard (providing the compose 
sequences have been loaded using either Setup, or the remote 
configuration file's compose _sequences command.) 

7-Bit International Fonts 

When using remap.dir to map fonts to 7-bit international character sets, you 
can use the files located in the /tekxp/examples/xmodmap directory to remap 
your keyboard for use with the 7-bit font. The following keyboard nationality 
files are available for use with 7-bit fonts: Danish, French, German, Italian, 
Spanish, Swedish, Swiss, and United Kingdom. Use xmodmap followed by the 
appropriate file to remap the keyboard. For example, to remap the keyboard for 
use with a 7-bit French font: 

xmodmap Xkm.french 
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Disabling the Keyboard Reboot Function 

The keyboard reboot function (Control-Alt-Delete) can be disabled using the 
remote configuration file, or using xmodmap. 

• In the remote configuration file (xp.cnf), set the control _alt_delete command 
to disable. 

• Using xmodmap, remove the Delete, or Control_L and Control_R keysyms, 
or the Alt_L and Alt_R keysyms from the keyboard. (If you do not want to 
remove them, you can map them to different keycaps on the keyboard.) You 
can use xmodmap to change the Alt_L and Alt_R keysyms to Meta_L and 
Meta_R, respectively. However, if you have a UNIX keyboard, mapping 
Alt_R disables Setup. To preserve Setup, first use xmodmap to change the 
Setup keysym. 

The following example illustrates using xmodmap to change the Setup, 
Alt_L, and Alt_R keysyms to F12, Meta_L, and Meta_R, respectively: 

xmodmap -e "keysym TekSetup = F12" 

xmodmap -e "keysym Alt_L = Meta_L" 

xmodmap -e "keysym Alt_R = Meta_R" 

After changing the keysyms, assign Meta_L and Meta_R to the modi 
modifier for applications that use the modi state of these. 

xmodmap -e "add modi = Meta_L Meta_R" 

Note: This also disables the Jus Language Shift mechanism. 

Although the Control- Alt-Delete keysyms provide the reboot function, if the 
server is locked up, you must cycle the power switch to reboot the network 
computer. 



NCBridge Reference Manual B-43 



K1 



Appendix B 



Num Lock 



Num Lock is disabled by default. To enable Num Lock, use xmodmap to 
assign a modifier to the Num Lock keysym; modifiers one through five can be 
assigned to Num Lock. When Num Lock is pressed, the Num Lock LED is 
turned on and a key press is sent. No key release is sent, therefore all subsequent 
key presses have the Num Lock modifier. 

The next time Num Lock is pressed, the Num Lock LED is turned off and a key 
release is sent. This essentially makes Num Lock a toggle similar to Caps Lock. 
To disable Num Lock, use xmodmap to clear the modifier. 

For example, to enable Num_Lock and assign it to mod2: 
xmodmap -e "add mod2 = Num_Lock" 

To disable Num_Lock on mod2 (and is not assigned to modi, mod3, mod4, 
or mod5): 

xmodmap -e "clear mod2" 

Note: Most Sun hosts assign modi for Num Lock, and most IBM hosts 
assign mod5 for Num Lock. 

Keep in mind that it is ultimately up to the client program to properly interpret 
the Num Lock modifier. Even if Num Lock is enabled, some clients may ignore 
the modifier or interpret it as another function. 

When using some host-based Motif Window Managers (MWM), the Num Lock 
assignments may interfere with normal MWM operations. Local MWM ignores 
the modifier bit assigned to the Num Lock key. Therefore, if host-based MWM 
is not working correctly when the Num Lock feature is enabled, use local 
MWM. However, local MWM does not work properly if the Num Lock key is 
assigned to more than one modifier. 
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National Keyboard Support 

International or multi-language keyboards generally require the ability to enter 
more graphic characters than the number of physical keys. The X server 
supports four mechanisms for additional character entry: 

• The Japan UNIX Society (JUS) language shift mechanism, designed for 
X11/R3. 

• The standard XI 1/R4 bilingual protocol change, which supersedes the JUS 
mechanism for R4 clients. 

• Compose and diacritical sequences. 

• DEC Data Processing keys (network computer LK401 -style keyboards 
only). 

The JUS Language Shift Mechanism 

This server-based mechanism was developed specifically to support keyboards 
with secondary Katakana or Hiragana key legends, prior to the definition of the 
XI 1/R4 bilingual protocol change. This mechanism supports languages other 
than Japanese (Alt-GR key) and also supports the 102-key keyboards. 

In the implementation of the JUS mechanism, the server recognizes a set of 
keysyms as identifying shift keys and emitting alternate key codes. Both 
shifting and locking keys are supported by attaching the desired keysym to the 
desired key. The default keysym for 102-key keyboards (excluding Katakana) 
is R-Alt. If you want to change the keysym back to _JUS_Kana_Shift, do one 
of the following: 

• Use the XP's xmodmap: 

xmodmap -e "keycode 6 5 = JUSKanaShif t" 
or 

• Add the following line to your .Xkm file: 

keycode 65 = _JUS_Kana_Shif t 

Then enter: 

xmodmap <name of .Xkm file > 
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The recognized keysyms are defined in the JUSkeysym.h and keysymdef.h 
include files as shown in Table B-9. When the keyboard is in the shifted state, 
a constant value is added to the physical keyboard key code to generate the key 
code sent to the client. On network computers, the value is 141. By attaching 
the desired keysym to the shifted key code, you can configure most keys on the 
keyboard to generate a different key code when the keyboard is in shifted mode. 
If the shifted key code does not have a keysym, the unshifted key code is sent 
to the client. 

Table B-9 Shifted Keysyms Defined in Include Files 



Function 


Keysym Name 


Keysym Value 


File 


Shift 


_JUS_Kana_Shift 


0xl000FF2E 


JUSkeysym.h 


Kana_Shift 


0xFF2E 


keysymdef.h 


R_Alt 


OxFFEA 


Locking shift 


_JUS_Kana_Lock 


0xl000FF2D 


JUSkeysym.h 


Kana_Lock 


0xFF2D 


keysymdef.h 



Alt-GR keysyms are available for certain ASCII characters which do not appear 
on the following keyboards. 

• Spanish 102-key keyboard: 

- Alt-GR exclamdown (upside-down exclaim) generates a tilde. 

• Italian: 

- Alt-GR 8 generates a braceleft. 

- Alt-GR 9 generates a braceright. 

- Alt-GR quoteright (apostrophe) generates a grave. 

- Alt-GR igrave generates a tilde. 

The X11/R4 Protocol Change 

This protocol change defines keysyms 3 and 4 in the keysym table as accessed 
by a language shift modifier identified by the Mode_switch keysym. It is 
implemented in the MIT sample XI 1/R4 Xlib. 
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Compose Sequences and Diacritical Sequences 

Compose sequences are multi-key sequences initiated by a special Compose 
key on the optional LK401 -style national keyboards. A compose sequence 
represents the desired character with a mnemonic or graphical composite. Here 
are two examples: 

Compose s/ represents $ 

Compose aa represents @ 

Diacritical sequences are two-key sequences that are initiated by a diacritical 
mark, for example, " (an umlaut). The diacritical mark is followed by the 
alphabetic character that is to have the diacritical mark added, for example, o 
(umlaut-o). 

The X server supports compose processing with clients that are based on 
standard MIT R3, R4, R5 or R6 Xlib. To accomplish this, the X server processes 
compose sequences internally, emitting a single key-press/key-release event 
pair for the entire compose sequence. Thus, compose sequences do not depend 
on host Xlib support and function consistently with all XI 1 clients on all hosts. 
Some clients provide their own language shift mechanisms, that generally 
operate independently from the server mechanisms. For example, 
DECWindows applications running on a network computer use their own 
compose processing if a key is configured with the Alt or Multi_key keysyms. 

Data Processing Keys 

On the optional LK401 -style national keyboards, the data processing keys 
access alternate symbols that are displayed on the right side of the affected 
keycap to allow direct entry of all ASCII characters. The keyboard is statically 
configured to either Typewriter or Data Processing mode, so that only two of 
the legends on a keycap (shifted and unshifted) are accessible at any given time. 
You can select the DP mode option for LK401 -style keyboards from the Main 
Menu of Setup. If you have configured Tek Compose support, and DP mode is 
off, you can also access the DP symbols by pressing the Compose key, followed 
by the key with the desired DP symbol. 
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DECwindows Keyboard Differences 

The DECterm Customize Keyboard menu allows you to change the meaning of 
several LK401 keys: Delete, </>, Shift-comma, and left-quote/tilde. DECterm 
performs this change internally without changing the server key map. In testing 
with several non-DEC keyboards, the affected keys no longer produce a 
character if you select key meanings other than the default. Use the following 
xmodmap file to obtain the same result on network computers globally for all X 
clients: 

keycode 110 = backspace 
keycode 73 = comma less 
keycode 81 = period greater 
keycode 22 = escape 
keycode 17 = grave asciitilde 

Restore the default operation with the following xmodmap file: 



keycode 


110 


= delete 


keycode 


73 


= comma 


keycode 


81 


= period 


keycode 


22 


= grave asciitilde 


keycode 


17 


= less greater 



DEC Compose support on VMS and Ultrix does not operate properly with non- 
DEC keyboards. Assigning Multi_key to the Compose key causes the Compose 
key to initiate a 3-key compose sequence. Assigning Alt_L to the Compose key, 
and pressing Compose-space does not initiate a 3-key compose sequence. 2-key 
compose (diacritical) sequences cannot be initiated, even when you use the 
private DEC diacritical keysyms. Other than using the Tek Compose method, 
there is no known workaround for this. (The Tek Compose method is currently 
available only on Ultrix.) 

Customizing the Keyboard Configuration 

The Main Menu of Setup shows the current keyboard selection, and, for 
LK401-style keyboards, indicates if you are using DP mode and whether 
compose sequences are loaded. 

For 102-key keyboards, alternate symbols are accessed by configuring the Alt- 
GR key with the _JUS_Kana_Shift keysym or Alt_R keysym, and by providing 
the desired keysyms in the shifted key code area. 
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Keyboard LEDs 

The keyboard LEDs can be turned on and off using the xset command. 
Table B-10 shows the LED assignments for the various keyboard types. 

Table B-10 LED Assignments 



Keyboard 


LED1 


LED 2 


LED 3 


LED 4 


LED 5-32 


101, 102,3270 
& 104/105 Win95 


Scroll Lock 


Caps Lock 


Num Lock 


None 


None 


UNIX 


Num Lock 


Compose 


Scroll Lock 


Caps Lock 


None 


LK401 X 


Hold Screen 


Lock 


Compose 


Wait 


None 


LK401 VMS 


Lock (off only) 


Compose 


Wait (off only) 


Hold Screen 


None 


LK401 Ultrix 


Wait 


Compose 


Hold Screen 


Lock (off only) 


None 


Katakana 102 


Scroll Lock 


Caps Lock 


Num Lock 


None 


None 


SunV 


Num Lock 


Compose 


Scroll Lock 


Caps Lock 


None 
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CSLIP 



The CSLIP feature (Compressed Serial Line IP) provides the ability to connect 
a network computer using a serial line to a remote IP network. This provides 
another net connection and enables you to print over a serial line. For example, 
when using Serial Xpress, you can use either a serial connection or an ethernet 
connection, or both. Also, any other IP based protocol works when using Serial 
Xpress via CSLIP. 

To use CSLIP as a network connection: 

• Configure your network computer to use CSLIP. 

• Start CSLIP. 

Configuring a Network Computer to Use CSLIP 

Network computers must be configured to use CSLIP. You can use Setup or the 
CSLIP command in the remote configuration file (xp.cnf). 

Configuring a Network Computer in Setup 

1. In Setup, drag on the Configuration Summaries menu to the CSLIP option. 

2. If CSLIP is disabled, click on the Disable button to Enable CSLIP. 
The CSLIP Configuration Menu displays. 

3. Set these CSLIP configuration options. 

Serial Port — Specify on which port to start the CSLIP session. 

Add Default Route — Specify whether the destination IP address is added as 
the gateway default in the gateway table. 

Compression — Specify whether compression is enabled or disabled while 
sending and receiving data. Select Allow if you want compression to be 
available if needed. 
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Destination IP Addr — Specify the address of the host to which you are 
connecting. 

Source IP Addr — Specify the network computer's IP address. IP addresses 
can be assigned dynamically by the host when dialing into a modem pool. To 
have the address assigned, leave this field blank. 

MTU — Specify the maximum transmission unit for data transmission. This 
value must match the server' s MTU value. 

Subnet Mask — Specify the subnet mask used for the CSLIP session. 

Protocol State — This option is used later in the process. Leave as is for now. 

Configuring a Network Computer in xp.cnf 

Use these remote configuration commands to configure a network computer for 
use with CSLIP. Refer to Chapter 2, Remote Configuration in this manual for 
details about each command. 

slip_compressionslip_mtu 
slip_serial_portslip_mask 
slip _de st _ip slip _def_route 
slip_src_ip 
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Starting CSLIP 



A CSLIP session can be started manually, or with a script. Follow these steps 
to start CSLIP: 

Starting CSLIP Manually 

1. Configure the CSLIP options for the network computer using either the 
CSLIP commands in the remote configuration file (xp.cnj), or Setup. Refer 
to Chapter 2, Remote Configuration or Chapter 3, Setup in this manual. 

2. Open a Serial Session window for the serial port where you are going to 
access CSLIP. 

3. Dial into the host. 

4. On the host, start the CSLIP session. Refer to your host documentation for 
details about configuring and starting CSLIP on your host. 

5. Quit the Serial Session. 

6. In Setup, drag on Configuration Summaries to CSLIP. 
The CSLIP Menu displays. 

7. In the Protocol State field, click on Activate. This starts CSLIP on the 
network computer. 

When CSLIP is running, you can then open a session window and log onto a 
host and start Serial Xpress or any other processes. 

Starting CSLIP with a Script 

The script must be located in the /tftpboot/tekxp/boot/config/script directory. 
The script name must also be included in the script Jiles file in the same 
directory. 

1. Configure the CSLIP options for the network computer using either the 
CSLIP commands in the remote configuration file (xp.cnj), or Setup. Refer 
to Chapter 2, Remote Configuration or to Chapter 3, Setup in this manual. 

2. Open a Serial Session window for the serial port where you are going to 
access CSLIP. 

3. Choose the Start Script command from the File menu. 
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4. In the Script Dialog box, select the name of the script and click the Start 
Script button. As the script runs, error messages display on the Tekterm 
client, and system errors display in the Console. 

To stop a script that is currently running, choose the Abort Script command 
from the File menu. 
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CSLIP Command-Line Options 



When starting CSLIP, you can specify the command-line options below can be 
specified. If specified, these options override parameters read from the network 
computer's NVRAM. The -port and -destination options are required when 
starting CSLIP. All others are optional. 

-ports Specifies the port number on which to start CSLIP. The 

default is 0. 

-mtu value Specifies the maximum transmission unit for the CSLIP 

interface. This mtu value should match the mtu value at the 
remote site. Default is 576. 

-compression 0, 1, 2 

Specifies whether TCP/IP headers are compressed while 
sending and receiving data. specifies no compression on 
Transmit and Receive sides. 1 specifies no compression on 
Transmit but it is ready to Receive compressed packets. 
However, as soon as the local CSLIP session Receives 
compressed packets, it starts compression on Transmission 
also. 2 specifies both allow and enable compression. The 
default is 2. 

-destination Specifies the destination to connect. Enter the destination as 

an address in decimal dot format, or by name. 

-source Specifies the source to connect. Enter the source as an 

address in decimal dot format, or by name. 

-subnet Specifies the subnet mask for this interface in decimal dot 

format. 

-add_default_route 

Specifies to add this CSLIP interface as the default route. If 
more than one default route is added, the last route takes 
precedence. By default, no default routes are added. 



-end 



-help 



Specifies to terminate already-established CSLIP 
connections. The -start and -end options cannot be given 
together. 

Prints the available CSLIP command-line options on the 
local console. 
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Examples 



The following example starts CSLIP on the machine named dolphin using serial 
port and enables compression for Transmission and Reception by default: 

xpsh cslip -destination dolphin 

The following example starts CSLIP using serial port 1 and accesses the 
destination address via the network computer's NVRAM. This disables 
compression while transmitting, and incoming compressed packets are not 
accepted: 

xpsh cslip -port 1 -compression 

This example terminates the CSLIP session currently running on port 0: 

xpsh cslip -end 

This example terminates the CSLIP session currently running on serial port 1 
and starts a tip session: 

xpsh cslip -port 1 -end start_tip 



C-6 NCBridge Reference Manual 



Appendix 



D 



Scripting Language 



A scripting language is now available to automate network computer functions 
that can be started using a Tekterm session. For example, you can create a script 
that starts PPP, logs you onto a specific host, and opens a session window to a 
Windows NT or UNIX host. 

The scripting language is very similar to functions used in the C language. It 
uses integer and string variables, flow control statements such as if, loop and 
goto, and special functions which can send characters on serial port or wait until 
a certain pattern is received on the port by setting timeouts. 

The scripting language has these features: 

• It is case-sensitive. 

• It is free format, multi-line, and structured. 

• It has no line/column orientation. 

• Its statement delimiter is ";" 

• The keywords for this scripting language are int, str, if, elseif, else, loop, 
goto, and break. 

• It supports both C and C++ style comments. 
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Creating a Script 

1 . Create a script using the rules in this section. 

2. Place the script in the /tekxp/boot/config/script directory. 

3. Add the script's name to the script J'iles file located in the 
/tekxp/boot/config/script directory. 

Sample Script 

There is a sample script in the /tekxp/boot/config/script directory called startup. 
This sample script provides examples for opening a serial session window and 
logging you onto a host, opening a Telnet window, and closing the serial 
session window. It also accesses a second sample script, named conn, which 
starts a CSLIP session in the open Telnet window, logs you onto a host that has 
sxprocess, and starts Serial Xpress. These scripts are also listed in the 
script J'iles file. 



D-2 NCBridge Reference Manual 



Executing a Script 



Executing a Script 



To execute a script, it must be in the correct script directory. For UNIX, this is 
/tekxp/boot/conf ig/script. For NT and Windows 2000 hosts, it is 
\tekxp\boot\conf ig\script . The VMS location for the script is 
tek$xp_config : . The script name must also be included in the script J'iles 
file in the same directory. 

1 . Open the TekSetup client and select Configuration Summaries > Session 
Manager. 

2. Under Connection Method, select Script. 

3. Provide the PPP login information for the script: 

- Enter the User Name for the PPP server. 

- Enter the Password for the PPP server. 

- Select Serial Port or 1, depending on where the modem is connected. 

- Enter the phone number for the PPP server. 

4. In the Script Dialog box, enter the name of the script (Start_PPP). 

5. Select Connect to establish the PPP connection to the PPP server. 

Note: To stop a script that is currently running, click Disconnect. 
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Remote Configuration Command 

This command has been added to the remote configuration file (xp.cnj): 

script_variable Command 

script_variable variable _name value 

This command defines variables and values used with scripts. Each network 
computer can use unique script variables and/or values. 

variable _name specifies the name of the variable. This name can be placed 
in a script and then accessed when the script executes. 

value specifies the value used for the variable defined above. One variable 
can have multiple values on different network computers. This allows 
you to customize network computer tasks. 

In the following example, the variable is Phone, and the value is 9837813. The 
variable Phone can be added to a script and when encountered, the phone 
number 98378 13 is accessed. The variable Phone can be used in different xp.cnf 
files on different network computers with different phone numbers as the value. 
This allows the network computers to use different phone numbers. 

script_variable "Phone" "9837813" 
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Language Specifics 

Variables 

The language supports two types of variables; integers and strings. Internally, 
integers are stored as 32-bit numbers. There is no built-in limitation on string 
lengths. It is limited by available RAM. All variables should be declared 
explicitly at the beginning of the program. The scope of variables is always 
global. String variables are initialized to represent string of length zero. 

To define a variable name, the first character must be a letter, subsequent 
characters can be letters or digits. No other symbols are valid. Here, a letter 
means a character from the set [a..z, A..Z, _] Sample valid declarations: 

int xyz, abc; 

str line [80], temp [20], name [75] 

int _count2; 

Sample invalid declarations: 

int 2qwerty, zzz[23], 

Literals 

There are two type of literals; string and integer. String Literal is a quoted 
string. 

For Example, "THIS IS QUOTED TEXT" is a string literal, Examples of 
integer literals are -234, 336, 2, 0. You can specify escape sequences in string 
literals. Most of the C language sequences like '\n', '\t' are accepted. You can 
also specify hex values directly by '\x<diglxdig2>'. This is a list of supported 
escape sequences: 

'\n' : Line Feed 

V : Carriage Return 

V : Tab 
'W : 'V 

Mil . Mil 

'\x<diglxdig2>': Convert the hex value represented by <diglxdig2>, 
to corresponding byte. For example, "\x3A" converts 
to ":". While specifying this sequence, both, upper-case and 
lower-case letters, are treated similarly. So, "\x3A" is same 
as "\x3a" or "VX3a". 
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Operators 



The scripting language supports the following arithmetic / logical / relational 
operators. The order of precedence is as in C language. 

Available Operators 

- : Unimary minus 

! : not 

* / : Multiply & divide (integer) 

+ - : Plus & minus 

> = < <= : Comparison operators 

== != : is equal, is not equal 

&& : Logical AND 

II : Logical OR 

= : Assignment 



Program Definition 



A program written in this scripting language consists of a list of variable 
declarations, followed by a list of statements. The list of declarations is optional. 
Variable declarations consist of string and integer declarations. A statement list, is 
a list of valid statements. Statements can optionally have labels. 

The statements in the scripting language can be any of these: 

• A blank line 

• A semicolon on a line (;) 

• Expressions 

These are always evaluated from left to right. Expressions are combinations 
of literals, variables and function calls created using operators and 
parenthesis. 

Examples 

-20; 

x; 

x = 2; 

x = x * 2 + (3 + y) * 5; 

(x>5&&x<10lly !=0) 

(NvGetVar("login", login) != -1) 
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Call to a Built-in function. For example: 

echo ("THIS IS OUTPUT ON STDERR"); 

exit 0; 

strcmp ("QWERTY", "QWE"); 

a = atoi("1234"); 

if_statement. 

The statements in an if block should be in curly braces. '{' and '}' and the 
expression associated with the condition must be in parentheses '(' and ')'. The 
language supports an elseif clause and an else clause. The syntax is as follows: 

if (exprn) 

{ /* Brackets are compulsory */ 

statement list 

} 

elseif (exprn2) /* This is optional */ 

{ 

statement list 

} 

else /* This is optional */ 

{ 

statement list 

} 

goto statement. For example, 

goto ERROR; /* ERROR is a label */ 

block. A list of statements in curly braces. For example, 

{ 

count = a * 3; 
if ( count > 10 ) 

{ 

echo("count is more than ten\n"); 

} 
} 
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Loop statement. Syntax for this statement is as follows: 

loop (expression) 

{ 

<statement list> 

} 

The statements in a loop block should be in curly braces for example, '{' and '}' 
and the expression associated with the condition must be in parentheses '(' and 
')'. The scripting language first evaluates the expression specified. Result of the 
expression defines the number of iterations of the loop block. It should be noted 
that the expression is evaluated only once, for example, before executing any 
statement in the loop block. For example: 

loop (count) 

{ /* Brackets are compulsory */ 

statement list 
} 

Break statement 

The program comes out of the current block and continues in the outer block. 
For example: 

loop (5) 

{ 

a = a- 1; 

if(a==l) 

{ 

break; 



CONTINUE: a = 4; 

/* when the break statement is executed the program 

* continues execution from CONTINUE: a = 4; 

* statement. 
*/ 
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Built-in Functions 

The scripting language supports a number of built-in functions: 

• String operations 

strncmp, strcat, strncat, strcmp, strcpy, strncpy, strcspn, strspn, stricpy, 
strincpy, strlen, strstr, strtok, sprintf. 

isalpha, isupper, islower, isdigit, isspace, ispunct, isalnum, isascii, toupper, 
tolower, toascii, atoi, itoa. 

These functions make it possible to carry out string manipulation with ease. 

• Input/output related functions 

echo, echochars, sendchars, recv, await, getkeyboard, setechomode, flush, 
setnoechomode, getTipPort. 

These functions are used communicate with host systems and with users. 
Communication with host systems is through TIP, Telnet etc. Communication 
with user is via Tekterm window. It is possible to send/receive data to host and 
user using these functions. 

• NVRAM related functions 

NvSetVar, NvGetVar, NvUpdateVars, GetTaglnt, GetTagStr, SetTagStr. 

These functions are mainly useful for parameterizing scripts. Script parameters 
can be stored in NVRAM. 

• Miscellaneous 

sleep, killparent, settimeout. 

Function Parameters 

For most functions (e.g., NvGetVar) all parameters are mandatory. For 
functions await and sprintf, you can specify a variable number of parameters. 
In a function call, parameters can be either variables or literals. However, for 
some functions, certain parameters are expected to be variables (e.g., parameter 
si in strcpy(sl, s2) ). Passing a literal in such cases results in a run-time error. 



NCBridge Reference Manual D-9 



K1 



Appendix D 



Script Parameters 

The previous section listed some functions which operate on NVRAM. This 
facility makes it possible to parameterize scripts. For example, consider the 
case of automating log-in operations through Telnet. Each person has a 
different log-in name and possibly a different host. The script accepts host name 
and log-in name as parameters. Setup provides a facility to define and save 
script parameters (under Network Tables and Utilities Menu). NvGetVar() 
assigns a value to a parameter. NvSetVar() sets a parameter. A subsequent call 
to NvUpdateVars() stores the parameter in NVRAM. 

The script parameters can also be set using remote configuration commands. 
The syntax in the xp.cnf file is: script_variable "<variable name>" "<value>" 
For example, to set the parameter login to be guest: 

script_variable "login" "guest" 

Usage of Various Language Constructs 

• Variable declarations 

str strl[22], stringvar[20]; 
int count; 

• Integer Assignments 

int b, c, d; 
b = c = 3; 
d = -3456; 

• String assignments 

strs[15]; 

strcpy(s, "Hello WorldV); 

• Expressions 

c == 3 // Result is zero or 1 

c * 3 + d // Evaluated with same precedence rules as 'C 

c * (3 + d) // Explicitly specifying order of evaluation 

c < 3 && c > 12 // Use of comparison and logical operators. 
// Precedence same as that in 'C. 

(NvGetVar("login", login) == 1) && (strlen(login) > 0)) // Use of function 
calls within expressions. 
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if statement 

if(c==3) 

{ 

echochars("3"); 

} 

elseif ((c == 2) II (c - c/6*6) == 0) 

{ 

echochars("2 or divisible by 6"); 

} 

elseif (c ==1) 

{ 

echochars("l"); 

} else { echochars("Some other value\n"); } 

Loop statement and break statement 

loop (count * 2 + 3) 

{ 

echochars("Looping...\n"); 
if (count > 100) 

{ 

break; 



// Changing value for count within the loop block does not 
// change number of iterations. 

sprintf example 

int a; 

strz[50]; 

a = 35; 

sprintf(z,"%s : %d base is %d\n", "value for a ", a, 10); 

Example of user input without echo (Useful for password entry etc.): 

str pass [25]; 

echochars("Password :"); 
setnoechomode() ; 
settimeout(15); 
getkeyboard(pass, 24); 
echochars("\nOK\n"); 
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Examples for keyboard input and NVRAM operations: 

str name_var[25], login[25]; 

// set timeout to 15 seconds. 

echochars("Enter your name :"); 

settimeout(15); 

// Get user input (through keyboard) for "name" 

getkeyboard(name_var, 24); 

// Set variable "name" 

if (NvSetVar ("name", name_var) == -1) 

{ 

echochars("Error setting variableVi"); 

} 

// Set variable "host" 

if (NvSetVar ("host", "falcon") == -1); 

{ 

echochars("Error setting variable\n"); 

} 

// Save the updated values in NVRAM. 

NvUpdateVarsO; 

// Get value for variable login. 

if (NvGetVar ("login", login) == -1) 

{ 

echo("Error reading variable"); } 

Examples of usage of some string functions: 

strincpy : 

// copy 3 characters to strl from displacement 2 in 

// string "abcdefghijk" 

strincpy (strl, "abcdefghijk", 2, 3); 

// strl will now contain "cde" 

strtok : 

// The following script results in display : 

//abc 

//def 

// ghijk 

strtok ("abc def ghijk", " ", strl); 

echochars (strl); echochars("\n"); 

strtok ("","", strl); 

echochars (strl); echochars("\n"); 

strtok (""," ", strl); 

echochars (strl); echochars("\n"); 
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• Example of receiving data from host: 

// Assume that host sends following string: 

// " Set address to : 128.1.0.25" 

// It is required to extract address from this string. 

// Following script achieves this. 

int a; 

straddr[20]; 

a = await("Set address to : ", 1); 

if(a==l) 

{ 

settimeout(3); 

// The script assumes that within next 3 seconds all the 

// required data will come. 

recv(addr, 15); 

// In case 15 characters are not received within the timeout 

// period, then 'recv' will put available characters in 'addr' 

// and return. 

echochars("Address is :"); 

echochars(addr); 

} 
else 

{ 

echochars("Did not receive address from host\n"); 

} 

Starting CSLIP Using a Script 

Note: See also the sample script named startup in the 
/tftpboot/tekxp/boot/config/script directory. 

II This script performs following functions: 

// a. Login for cslip account on host 

// b. Start local cslip 

// c. Invoke a Telnet session 

int c; 

str login[25]; 
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II Get login name for cslip from NVRAM 
if (NvGetVar("login", login) == -1) 

{ 

// Could not get the variable from NVRAM 

echochars("variable login not defined in NVRAM\n"); 

exit(); 

} 

// Could get the variable from NVRAM 

// Set timeout to 15 seconds, 
settimeout (15); 

// Flush buffer for data from host. 
flush(); 

// Send a '\n' so that host will respond with login prompt 
sendchars ("\n"); 

// Wait to receive login string from host 
c = await ("login", 1); 

if(c==l) 

{ 

// Received login prompt 

// Send login name for cslip 
strcat(login, "\n"); 
sendchars(login); 

// In our setup, starting host-cslip does not require password. 
// A login immediately results in startup of cslip on host 

// Await for a startup message 

c = await ("starting", 1, "willing to manage", 2, "Willing to Manage", 3, 
"cslip started", 4); if (!(c == 1 II c == 2 II c == 3 II c == 4) ) 

{ 

echo ("\n Could not start cslip on the host.. .An"); 
exit(); 
} 
} 
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else 

{ 

// Did not get login prompt from host 

echochars ("\n No Response, ...CSLIP is probably already started on 

hostAn"); 
} 

// Download Telnet so that login over cslip can be done 
exec ("tek340 -e telnet"); 

// Download local cslip 
exec ("cslip"); 

// Kill the Tekterm(TIP) session to allow local cslip to 

// take control of serial port 

killparentO; 

// END of script for CSLIP // 
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These commands 
Table D-1 General 
Command 



isalpha() 
isupper() 
islower() 
isdigit() 



isspace() 



ispunct() 
isalnum() 
isascii() 
isxdigit() 



isprint() 



iscntrl() 



isgraph() 

toupper() 
tolower() 
toascii() 



are available with the scripting language. 
Commands 
Description 



Checks if passed argument is an alphabetic string. Returns 1 if true, if 
false, and -1 on ERROR. 

Checks if passed argument is an upper case string. Returns 1 if true, if 
false, and -1 on ERROR. 

Checks if passed argument is a lower case string. Returns 1 if true, if 
false, and -1 on ERROR. 

Checks if passed argument is a string of digits. Returns 1 if true, if 
false, and -1 on ERROR. 



Checks if passed argument is a string of spaces. Returns 1 if true, if 
false, and -1 on ERROR. 



Checks if passed argument is a string of punctuation. Returns 1 if true, 
if false, and -1 on ERROR. 

Checks ifpassed argument is a string of alphanumeric. Returns 1 if true, 
if false, and -1 on ERROR. 

Checks if passed argument is a string of ASCII. Returns 1 if true, if 
false, and -1 on ERROR. 

Checks if passed argument is a string of hex digits. Returns 1 if true, 
if false, and -1 on ERROR. 



Checks ifpassed argument is a string of printable characters. Returns 1 
if true, if false, and -1 on ERROR. 



Checks if passed argument is a string of delete or control characters. 
Returns 1 if true, if false, and -1 on ERROR. 



Checks ifpassed argument is a string of visible graphic. Returns 1 if 
true, if false, and -1 on ERROR. 

Converts string s2 to a string of upper case characters. Returns 1 on 
success. 

Converts string s2 to a string of lower case characters. Returns 1 on 
success. 

Converts string s2 to a string of ASCII characters. Returns 1 on success. 



atoi() 



Converts the string si to an interger equivalent and returns it. 
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Table D-1 General Commands (continued) 



Command 


Description 


itoa() 


Converts the interger n to its string equivalent in si. 


stxcpyO 


Copies source string s2 to destination string s 1 . 


strncpyO 


Copies as most n characters from source string s2 to destination string 
si. In case source string is shorter than n, destination string is null 
padded. 


strcat() 


Concatenates source string s2 to the end of destination string s 1 . 


strncat() 


Concatenates at most n characters from source string s2 to the end of 
string s 1 . 


strlen() 


returns length of string. 


strcmpO 


Compares string si to sting s2. Returns an interger greater than, equal 
to, or less than 0, depending on whether si is lexicographically greater 
than, equal to, or less then s2, respectively. If parameters are improper, 
it returns -257. 


strncmpO 


Compares at most n characters of string s 1 to string s2. Returns the same 
values as for strcmp. 


strspn() 


Gives the length of prefix of si consisting of characters in s2. 


strcspn() 


Gives the length of prefix of s 1 consisting of characters not in s2. 


strstr() 


Gives the offset to first occurrence of string s2 in string si, or -1 if not 
present. 


strtok() 


Searches string s 1 for tokens delimited by characters from s2 and returns 
the NULL terminated token in the string s3. The first call in a sequence 
of calls should have a non-empty string si. The string si may be 
different on each call. 


stricpyO 


Copies characters from the given index i from string s2 to string si. 


stxincpyO 


Copies at most n characters from the given index i from string s2 to 
string s 1 . 


sprintf() 


Similar to the corresponding function in'C library. However, it 
provides only a subset of functionality provided by the'C library 
function. Outputs string si using the format string fit and the list of 
values specified. It supports only these two formats: 

%d: for printing integers. 

&s: for printing strings. 

There is no limitation on the number of arguments to this function. 
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Table D-2 NVRAM Access Commands 

Command Description 

NvGetVarQ Gets string value for the named script variable. Returns 1 

to indicate success, or-1 if the variable does not exist, or 
if a wrong argument is passed. 

NvSetVar() Sets value for the named script variable. Returns 1 if the 

operation succeeds, and -1 if it fails. The value does not 
actually get updated in NVRM until NvUpdateVars() is 
called. It does, however, set the tag corresponding to 
script variables. 

NvUpdateVars Updates NVRAM with current tag values. It takes some 

time to update NVRAM. Returns 1 on success and -1 on 

failure. 



Table D-3 System Related Commands 



Command 


Description 


echo() 


Outputs the specified string on console. Always returns 1. 


exec() 


Downloads and executes a task. For example, exec("tek220 -e telnet"); 
Returns 1 on success and -1 on failure. 


exit() 


Exits from the task. 


sleep() 


Sleeps for the specified number of seconds. Returns 1. 


settimeoutQ 


Sets the time out for all the operations which need a timeout. Functions 
await, recv, and gefkeyboard require timeout to be set. The default value for 
timeout is 10 seconds. 


gefkeyboard() 


Waits for the user to enter a string of length 'len' or a new line terminated 
string from the keyboard. On return, it puts user's input in the buffer passed. 
The buffer is null terminated and new line character typed by user is 
stripped. 


recvQ 


Waits for a string of length 'len' from the host, or for the timeout period. 
This function is used to receive data from the connected host. The 
connection could be through Telnet or TIR Received data is returned in the 
buffer passed. It is null terminated as well. If timed out, this function returns 
the available data. 
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Table D-3 System Related Commands (continued) 



Command 


Description 


flush() 


Flushes the keyboard buffer and the buffer for data from host. Also flushes 
any data in the pipe used between tekterm and script. Is typically used when 
the host sends large amounts of data. If this data is not flushed out, there is a 
chance that local buffers in the scripting language may overflow. In this case, 
some of the data coming from the host may be discarded. 


setechomodeO 


Sets the characters typed on the keyboard to be echoed on the screen when 
typed. 


setnoechomode() 


Prevents the echoing of characters typed from the keyboard. It can be used 
when user is entering data through the keyboard that is being captured using 
the "getkeyboard" function. If setnoecho() function is called before doing 
"gefkeyboard", then data being entered by the user is not echoed on the 
screen. This facility is useful for entry of information such as a password. 


killparent() 


Kills the parent Tekterm from which the script is executed. This also results 
in ending the script. 


echochars() 


Echoes the string given as its argument on the display (i.e. the Tekterm 
window) 


sendchars() 


Sends the argument string to the host. The host connection could either be 
through TIP or Telnet. 


await() 


Takes variable parameters as input. Parameters are specified two at a time. 
The first parameter is a string and the second is a value. The command waits 
for one of the specified strings to come from the host and returns the value 
associated with the string. It waits for a period specified by settimeout(). If 
none of the specified strings is received within this time, then it returns -1. 
The check for string match is from left to right. Therefore, if more than one 
match is possible then the value corresponding to the left-most string is 
returned. A string match also causes corresponding data from the host to be 
flushed. 
Example: await("login", 1, "LOGIN", 1, "fail" ,2); 


getTipPort() 


Returns the serial port number through which the current scripting language 
session was invoked. If the script is invoked via a TIP session for serial port 
(or port 1), then getTipPort returns (or 1, for port 1). If the script was not 
invoked via a TIP session then it returns -1. 
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translation settings 7-12 
tek220_answerback 2-134 
tek220_autorepeat 2-133 
tek220_autowrap 2-128 
tek220_blink_cursor 2-134 
tek220_cursor_key_mode 2-132 
tek220_cursor_style 2-129 
tek220_dev_attr_resp 2-131 
tek220_emulation 2-130 
tek220_keypad_mode 2-132 
tek220_newline_mode 2-133 
tek220_num_col 2-128 
tek220_rev_video 2-129 
tek220_reverse_colors 2-136 
tek220_user_features 2-131 
TEK340 emulator 2-166-2-167 
Tek340 emulator 

character attributes 7-15 

Client resources 7-7 

starting 7-1 

translation settings 7-12 
tek340_answerback 2-134 
tek340_autorepeat 2-133 
tek340_autowrap 2-128 
tek340_blink_cursor 2-134 
tek340_cursor_key_mode 2-132 



tek340_cursor_style 2-129 

tek340_dev_attr_resp 2-131 

tek340_emulation 2-130 

tek340_keypad_mode 2-132 

tek340_newline_mode 2-133 

tek340_num_col 2-128 

tek340_rev_video 2-129 

tek340_reverse_ANSI_colors 2-136 

tek340_user_features 2-131 

TekHostMenu (HostMenu) 2-36 

TEKLOGIN, downloading and starting 2-95, 2-109 

teklogin_close_on_connect 2-230 

teklogin_default_session 2-230 

teklogin_force_fullscreen_windd 2-230 

teklogin_require_login 2-228 

teklogin_save_passwords 2-229 

teklogin_show_sessions_in_launcher 2-229 

teklogin_timeout 2-228 

tekterm_menubar 2-135 

telnet_exit_on_logout 2-178 

telnet_menu_entry 2-166 

terminal_name 2-52 

terterm_resource_control 2-135 

Text fields, editing 3-10 

TFTP 4-8 

fhm_broadcast 2-164 

fhm_entrybox 2-165 

Token-Ring interface 2-94 

tokenstat 4-23 

Touch Screen configuration 2-80 

touchSc_Down_Threshold 2-82 

touchSc_Jitter 2-83 

touchSc_Max_X 2-82 

touchSc_Max_Y 2-82 

touchSc_Min_X2-81 

touchSc_Min_Y2-81 

touchSc_Up_Threshold 2-83 

Touchscreen calibration client, starting 2-77 

Translations 

keyboard modifiers 7-13 

print screen function 7-13 

securing the keyboard 7-13 

string action 7-12 
Trident Touchscreen 2-87 
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trigger_reboot_password 2-59 
tty_abort_session_0 2-66 
tty_abort_session_l 2-67 

u 

UIS, using B-4 
Unix integration services B-4 
Unix-style keyboard B-9 
unsupported_features_warnings 2-118 
update_authkey 2-208 
update_bootrom 2-160 

V 

vendor_string 2-42 
verbose_boot_msg 2-49 
Version, Network computer 3-3 
video_attribute_group 2-181 
video_encoding 2-183 
video_field_duplicate 2- 1 86 
video_multicast_entry 2-190 
video_source 2-180 
video_source_label 2-179 
video_switch 2-185 
video_visual_preference 2-182 
video_volume 2-184 
video_window_position 2- 188-2- 189 
video_window_size 2-187 
VMS Logicals 2-2 
vms_autologin_tcpip_host 2-39 
vms_autologin_tdenet_host 2-38 
vms_autologin_transport 2-38 
vms_menu_entry 2-165 



w 

WinDD, downloading and starting 2-95, 2-109 
windd_app_domain 2-198 
windd_app_login 2-198 
windd_app_name 2-197 
windd_app_pass 2-198 
windd_auto_connect 2-199 
windd_auto_login 2-197 
windd_auto_reconnect 2-199 
windd_entrybox 2-200 
windd_host_entry 2-196 
windd_menu_entry 2-169 
windd_menubar 2-200 
windd size 2-199 



X Display Manager (xdm) 

HostMenu 2-36 
X Environment 

configuration 2-24 

menu 3-15 
X Environment configuration 2-24 
X server 1-3 
X System Model 1-2 
X Window System 1-1 
XDMCP security features 2-35 
xdmcp_connect 2-36 
xdmcp_keepalive 2-37 
xdmcp_menu_entry 2-164 
Xlock client 1-4 

Xlock client, downloading and starting 2-95, 2-109 
XMODMAP, using to remap key codes B-41 
XP Window Manager 1-4 
xp_boothost 2-46, 3-20 
XpressWare Window Manager, downloading and 

starting 2-95, 2-109 
XPT/A Graphics Tablet 2-87 
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